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Preface 



This manual provides operating instructions to the operator, and planning and installation instruc- 
tions for the network administrator. The operators portion of this manual includes instructions 
and procedures for operating the Poller, as well as descriptions of operator commands. The in- 
tended audience for this portion of the manual is an operator familiar with operation of the DX10 
operating system in a Model 990 Computer and with operation of Model 990 Computer peripheral 
devices. The operator is not necessarily trained in computer science or programming. The 
administators portion of this manual provides information for a network administrator or systems 
analyst who plans, installs, and modifies the Poller network. The network administrator must be a 
systems programmer familiar with DX10 and with communications systems. Specifically, com- 
munications systems include the DX10 3780 Emulator and DX10 Bubble Memory Terminal Support 
(BMTS). The network administrator should also be familiar with the TIBOL language and applica- 
tions, and the Model 763, 765, 767, and 769 Bubble Memory Terminals. 

The DX10 Poller collects data from and distributes data to intelligent terminals using switched 
lines. It executes under a DX10 operating system (Release 3.4.0 or later) and uses either 3780 or 
TTY protocol. The Poller can also perform limited processing of communicated data. 

The manual contains the following sections and appendixes and a glossary of Poller terms: 

Section 

1 Overview — Presents an overview of the DX10 Poller application software. This section 
contains information for both operators and network administrators. 

2 DX10 Operations — Describes the execution of the Poller. This section contains infor- 
mation for both operators and network administrators. 

3 Operator Instructions — Describes operator commands and shows command formats. 
The commands described in this section control the Poller and its communication lines, 
specify and define manual operation of a line, perform transfers of data between media 
of the system, and display status information. This section contains operator 
information. 

4 Network Administrator Instructions — Describes commands the network administrator 
uses to define the network to be polled. Specifically, these commands create, modify, 
delete, display, and print the data structures that define the network to the Poller. This 
section contains network administrator information. 

5 Network Implementation — Provides worksheets to assist the network administrator in 
specifying the line hardware, memory, and disk space required for the Poller network. 
Also describes system generation requirements. This section contains network 
administrator information. 
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Appendix 

A Summary of Poller Commands — Lists the Poller commands in a table. 

B Poller Error/Status Messages and Error Recovery — Lists in a table the error and status 
messages issued by the Poller. Includes descriptions of status and error messages and 
of recovery procedures for error conditions. 

C Remote Terminal Characteristics — Describes the characteristics of the terminals in 
the Poller network in terms of options required. 

D ASCII Code Chart — Lists the characters of the ASCII code in a table. 

E ASCII/EBCDIC Conversion — Lists the characters of the ASCII code with the corre- 
sponding characters of the EBCDIC code. 

F Communications Cabling Diagrams — ■ Shows cabling diagrams for interconnecting ter- 
minals, modems, automatic calling units (ACUs), and data access arrangements to pro- 
vide Poller network communications. 

The following manuals contain additional information related to DX10 Poller application software: 

Title Part Number 

Model 990 Computer DX10 Operating System Concepts 

and Facilities Manual, Volume I 946250-9701 

Model 990 Computer DX10 Operating System 

Production Operation Manual, Volume II 946250-9702 

Model 990 Computer DX10 Operating System 

Application Programmer's Guide, Volume III 946250-9703 

Model 990 Computer DX10 Operating System 

Developmental Operation Manual, Volume IV 946250-9704 

Model 990 Computer DX10 Operating System Systems 

Programming Guide, Volume V 946250-9705 

Model 990 Computer DX10 Operating System Error 

Reporting and Recovery Manual, Volume VI 946250-9706 

Model 990 Computer DX10 Bubble Memory Terminal 

Support (BMTS-990) User's Guide 2276860-9701 

Models 763/765 Operating Instructions 2203664-9701 

Models 763/765 Memory Terminals Systems Manual 2203665-9701 



IV 
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Title 

Models 767 and 769 Electronic Data Terminals 
Operating Instructions 

Models 767 and 769 Electronic Data Terminals 
Systems Manual 

Model 990 DX 3780/2780 Emulator User's Guide 

The following IBM manual contains related information: 

OS Tape Labels 



Part Number 

2207960-9701 

2207961-9701 
946289-9701 

GC-6680-5 
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Overview 



1.1 INTRODUCTION 

The DX10 Poller software, in combination with the associated hardware and systems software, 
provides a versatile computer-based communications system. This communications system 
serves as a central data collection, distribution, and control point for remote terminals operating 
primarily over a switched telephone line network. It can support simultaneous polling activities 
with various terminals on multiple lines. Meanwhile the operator controls and monitors Poller 
operation, and performs various other functions. 

The Model 91 1 Video Display Terminal (VDT) serves as the user interface for both the operator and 
network administrator functions. An additional printer console (for example, a Tl 810 printer) pro- 
vides hard copies of any Poller reports and statistics the user desires. 

Used as an add-on package under the DX10 operating system for the DS990 minicomputer 
systems, the Poller supports a wide range of disk drives. A minimum configuration requires the 
use of two DS10 disk drives. The following types of data are maintained on disk files: 

• Poller configuration information (data bases) 

• Status logs 

• Source of received data and destination of transmitted data 



1.2 LINE OPERATIONS 

Each communications line can be configured to use any of the following three modes: 

• Auto call 

• Auto answer 

• Manual call/answer 

1.2.1 Autocall 

In auto call mode, which is the basic operating mode, the Poller automatically dials the remote ter- 
minals. When a connection is made, the Poller performs its specified polling activity according to 
the instructions contained in the activity template data base. The Poller then disconnects the line 
and automatically dials the next terminal using that line. 
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1.2.2 Auto Answer 

In this mode, the remote terminal operator initiates a call into the Poller system. The Poller 
establishes a communications line to receive incoming calls and then waits for a call. When the 
remote terminal calls and a connection is made, the Poller begins the polling activity. Once a ter- 
minal completes a successful session with the Poller, it cannot call in to the system until the 
Poller is terminated and restarted. (See paragraph 5.5 for Poller Initialization (PIN) command 
options.) 

1.2.3 Manual Call/Answer 

In this mode, the Poller operator is responsible for establishing the communication link with the 
remote terminal. The operator can dial the remote terminal telephone number or instruct the Poller 
to dial it. When a connection with a remote terminal is established, the operator can manually 
issue all required commands to transmit data to and from the terminal or the operator can initiate 
an automatic polling activity with the terminal by utilizing an activity template data base. 



NOTE 

The Poller places no restrictions on the combinations of operating 
modes that can be active at the same time. For example, in a four- 
line Poller, two lines can be activated for AUTO CALL, one for AUTO 
ANSWER, and one for MANUAL CALL/ANSWER. 



1.3 MAJOR FUNCTIONS 

The Poller performs the following major functions in any of the three operating modes: 

• Data collection 

• Data distribution (such as messages, data files, and program files) 

• Limited processing 

1.3.1 Data Collection 

The Poller collects data by transferring information stored on the storage medium (bubble 
memory or disk) of the remote terminal to the storage medium (disk) of the polling computer. 

1.3.2 Data Distribution 

The Poller distributes data by transmitting DS990 disk files to remote terminals. The central disk 
files can contain data that the terminal uses, program object files (executable programs), or 
messages that the remote terminal displays. 

1.3.3 Limited Processing 

The Poller provides you with the capability to add tasks to perform limited processing functions 
on the data files that are sent to or received from the remote terminals. The Poller invokes these 
tasks during the terminal session (while the terminal is connected to the Poller) to perform simple 
arithmetic or data verification functions. 
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1 .4 TYPICAL TERMINAL POLLING 

A terminal polling session may consist of the following activities: 

Connection — Poller calls the remote terminal. 

Data Collection — Poller retrieves an entire file from the remote terminal. 

Limited Processing — Poller invokes a user task on the DS990. 

Data Distribution — Poller sends an entire file to the remote terminal. 

Disconnection — Poller terminates the polling activity with the remote terminal and 
disconnects the line. 



1.5 POLLER SOFTWARE STRUCTURE 

The Poller application software consists of six parts, as shown in Figure 1-1. The following 
paragraphs briefly describe these parts. 

1.5.1 Configuration Management Utilities 

The configuration management utilities create, modify, delete and verify the data structures 
before a polling activity. The network administrator can access configuration management 
utilities through the DX10 System Command Interpreter (SCI). The data structures are in disk files 
and are verified as they are created. Individual data structures cannot be modified while they are 
being used by the Poller or by using the Text Editor. For details on the configuration management 
utilities, refer to Section 4. 

1.5.2 Poller Operation Utilities 

The Poller operation utilities control the operations of the Poller. Poller operation utilities can 
start, halt, restart, terminate, abort, or test the Poller. They are accessed through SCI commands 
and menus,. Other operation utilities display the line, terminal or Poller status; move data to/from 
magnetic tape; or allow manual interfacing with the Poller and DX10. For details on the Poller 
operation utilities, refer to Section 3. 

1 .5.3 Poll Master Task (PMT) 

The following list describes the major functions of the Poll Master Task: 

Initialize data structures, work areas, and resources 

Create data or commands for the appropriate terminal 

Direct data or commands to the appropriate communication subsystem 

Process data or command status received from the remote terminal via a communi- 
cation subsystem 

Maintain information on polling activity 
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Figure 1-1. Poller Application Software Components 
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1.5.4 Error Logging Task 

The error logging task records the various types of Poller errors, messages, and statistics to the 
files and/or devices specified by the network administrator in the Poller data base file. If the data 
is logged to a 91 1 VDT (STxx) or to a printer (LPxx), then the error logging task logs only the first 80 
characters and converts all control characters (value less than 20 hexadecimal) to spaces. You can 
display or print the contents of the log files using the Show Log Files (SLF) and List Log File (LLF) 
commands described in paragraphs 3.6.5 and 3.6.6, respectively. 

1 .5.5 Presentation Service (PS) Tasks 

The presentation service (PS) tasks convert the PMT commands to the appropriate protocol func- 
tions for the communication subsystem being used. The Poller software contains two different PS 
routines: PSTTY765 that supports the Model 763/765 terminals, and PS3780 that supports Tl 
767/769 and 990 terminals. The PS tasks are replicated for each line supporting its protocol and are 
assigned a priority of 1 to ensure prompt data handling. 

1.5.6 Communication Subsystems 

The communication subsystems transmit and receive data to and from the remote terminal. The 
BMTS-990 package handles transfers between the Poller and a Model 763 or 765 terminal; the 
DX10 3780 Emulator handles the interface between the Poller and remote 3780 devices (such as 
Models 767/769 or DS990). For details on the BMTS-990 and DX10 3780 packages, refer to the 
documents referenced in the Preface. 

1.5.7 Poller Communications 

The relationship between the PMT, the PS tasks, and the communication subsystems is shown in 
Figure 1-2. The configuration shown includes both PS tasks and both communication sub- 
systems. When all the terminals are Models 763 and 765 terminals, only PSTTY765, the BMTS-990 
package, and DSRTPD are required; when the network consists only of Models 767 and 769 ter- 
minals and/or 990 computers executing 3780 Emulators, only PS3780, EM3780, and 3780 DSR are 
required. 



1.6 POLLER DATA STRUCTURES 

The PMT uses data structures to determine which physical lines are available for use, which ter- 
minals can have activity sessions with the Poller, and what activities are to take place during the 
polling operation. The following data bases are created by the network administrator using the 
configuration management utilities to supply the required information to the PMT for use during 
the polling sessions: 

Terminal list 

Terminal data base 

Activity template 

Terminal procedure data base 

Poller data base 

Each of these data bases is specified directly or indirectly for each Poller occurrence as shown in 
Figure 1-3. 
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Figure 1-2. Poller Communication Software 
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Figure 1-3. Data Structures for a Poller Occurrence 
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1.6.1 Terminal List 

The terminal list is a list of the numbers of all remote terminals that can participate in a given poll- 
ing activity. Each terminal in the terminal list must have a corresponding entry in the terminal data 
base. The order of the terminals in the terminal list is the order in which the Poller attempts to poll 
the terminals. 

1.6.2 Terminal Data Base 

The terminal data base is an ordered set (by remote terminal number) of physical attributes of each 
terminal in the terminal list. Each terminal entry references the activity template that is used 
during the polling activity with the terminal. Terminal data base entries for terminals not in the 
terminal list are ignored during the polling activity. 

1.6.3 Activity Template 

An activity template defines the generic procedures that the poller performs during a polling 
session with an individual terminal or group of terminals. This template references the terminal 
procedure data base that defines in detail the commands to be executed. 

1.6.4 Terminal Procedure Data Base 

The terminal procedure data base contains the specific Poller and terminal commands along with 
the DX10 or terminal file names needed to define Poller activity template procedures. 

1.6.5 Poller Data Base 

The Poller data base is the set of physical resources available to the Poller. These resources in- 
clude the number of lines and their attributes (such as protocol, modem, and baud rate). The Poller 
data base also includes the log files and/or devices to be used and the type of information to be 
logged to each. 
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1.7 HARDWARE COMPONENTS 

The following major hardware components comprise the minimum DS990 hardware system that 
supports the Poller software: 

Model 990/10 or 990/12 Computer 

Main memory with mapping, 256K bytes 

Model 911 VDT operator console 

Model 810 Impact Printer 

Disk drive(s) with the appropriate controller as follows: 

— DS10 (9.4 megabytes) (two disk drives recommended) 

— DS25 (22.3 megabytes) 

— DS50 (44.6 megabytes) 

— DS200 (169.5 megabytes) 

— CD1400 (32 or 96 megabytes) 
At least one of the following kits: 

— 990 communications interface 

— Bell data set interface 

NOTE 

Refer to Section 5 for details on DS990 system configuration. 
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1.8 HARDWARE OPTIONS 

The hardware options for a Poller package consist of the following kits: 

External automatic calling (ACU) unit interface 

Communications interface kits 

Internal synchronous modem (Bell 201 type) and ACU 

979A tape drive (800 bpi or 1600 bpi) 

Additional 911 VDTs and controllers 

Utilizing additional hardware from this list of system options may require the addition of an expan- 
sion chassis to the main processor chassis. Information regarding expansion chassis planning is 
contained in the Texas Instruments computer family catalogs. See the 77 Computer Family 
Catalog (TI-557C-20M-1/81) and the Tl Computer Family Price List (TI-551-20M-2/81). 

1.8.1 External ACU and Communications Interface 

The external ACU interface kit and communications interface kit can be used to connect the 
DS990 system to various types of external modems and automatic dialers. 

1.8.2 Internal Synchronous Modem and Auto-Call Unit 

The 201 modem and ACU kits can be utilized to support 3780 protocol only. 

1.8.3 Model 979A Tape Drive 

This 979A tape drive is recommended where an industry compatible tape is required for transfer- 
ring data to a host system. If a 3780 Emulator is installed on the system, the Emulator can be used 
to transfer data to a host system. 

1 .9 REQUIRED SOFTWARE 

The following software packages are necessary with the specified applications: 

• DX10 operating system (Release 3.4.0 or later) 

• DX10 EM3780 (3780 communications only) (Release 4.0.0 or later) 

• BMTS-990 (TTY communications only) 
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2.1 INTRODUCTION 

The Poller application software executes under DX10. It supports a set of menus and commands 
that are implemented as System Command Interpreter (SCI) menus and commands. These menus 
and commands become available to an operator or network administrator through the POLL com- 
mand described in a subsequent paragraph. 

The command examples in this manual use the following symbol to represent the SCI request for 
input: 

[] 

The menus provided by the Poller are accessed by entering a mnemonic that begins with a slash 
(/). As in SCI, you may enter the desired command directly without first displaying the menu that 
lists the command. 
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2.2 POLL COMMAND 

The POLL command activates the Poller and enables the Poller commands and menus. The 
system displays the following screen when the command is entered: 



USE POLLER DIRECTORY 

POLLER DIRECTORY NAME: a com 
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POLLER DIRECTORY NAME is the pathname of the directory under which the Poller application 
software was installed. 

The POLL command assigns synonym V to the pathname entered, assigns global LUNO >81 
to Poller program file V.P$PROGA, and assigns global LUNO >82 to DX3780 program file 
.S$COMMPF. The command then displays the following menu: 



«MHMMkHMMM«MMMHM«IIMMIHMIiillllMii 




POLLER UTILITIES 



/POPER - POLLER OPERATION UTILITIES 
/PCONFG - POLLER CONFIGURATION UTILITIES 
PQ - RETURN TO DX10 SCI MENU 




LI 
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The POLL command makes Poller commands as well as SCI commands available for execution at 
the terminal until the PQ command is entered. 

Where no 3780 Emulator is installed, the POLL command returns an error message. You can sup- 
press this message by applying an optional patch described in the DX10 Poller Application Soft- 
ware Object Installation Manual. 

The Poller operation utilities are used by the operator to control the Poller execution. These 
utilities are described in Section 3. 

The Poller configuration utilities are used by the network administrator to set up and maintain the 
data bases required by the Poller. These utilities are described in Section 4. 
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2.3 PQ COMMAND 

The PQ command returns to the main SCI menu. Poller commands are not available after execu- 
tion of this command. Poller synonyms (except for two) are deleted. The PQ command is entered 
as 'Ollows: 





c :i pq 






The two Poller synonyms that remain after execution of the PQ command are V (assigned to the 
Poller software directory pathname) and $OCC$ (assigned to the occurrence number, which is the 
run-time ID of the most recent execution of the Poller task). The command does not release global 
LUNOs >81 and >82. 
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3.1 POLLER OPERATION UTILITIES (/POPER) 

The operator interfaces with the Poller by using the Poller operation utilities. These utilities are 
accessed via System Command Interpreter (SCI) menus and commands from a Model 911 VDT. 

The operator uses the operation utilities to start, terminate, halt, restart, abort, or test an occur- 
rence of the Poller. The operator uses another set of commands to terminate, abort, and restart the 
activities on an individual Poller line. 

Other Poller operation utilities provide for the displaying or printing of line, terminal, or Poller 
status, as well as the displaying or printing of formatted reports of the Poller log files. 

Additional operation utilities provide commands that allow the operator to manually interface with 
the Poller in order to test or debug the Poller network. 

Finally, there is a set of Poller operation utilities for tranferring data between DX10 disk files and 
magnetic tapes. These tapes can then be processed on a host system. 

Since operators at multiple Model 911 VDTs can execute Poller commands simultaneously, one 
VDT should be designated as the operator console and all commands which control the Poller 
(/PCTRL, /PLINE, /PMANL, /PMEDM) should be initiated from that terminal. The additional VDTs 
should therefore be used only for requesting reports through the Poller status commands 
(/PSTAT). 

Most Poller operation utilities require input of the Poller occurrence number; this number is the 
run-time ID of the Poll Master Task (PMT). The concept of an occurrence of the Poller is used 
because status information from previous Poller occurrences is maintained on disk for later 
access by the user; this data is accessed by the Poller occurrence number. This number is pro- 
vided as a default on the Model 91 1 VDT which starts the Poller (see SPO); at another station, you 
may determine this number by executing the RPS command. 
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This section discusses the Poller operation utilities commands. When the operator enters the 
/POPER command, the following menu of Poller operations will be displayed: 




■'OLLER OPERATION UTILITIES 

/PCTRL - POLLER SYSTEM CONTROL COMMANDS 

/PLINE - POLLER LINE CONTROL COMMANDS 

/PMANL - POLLER MANUAL CONTROL COMMANDS 

/PMEDM - POLLER MEDIUM TRANSFER COMMAND:; 

/PSTAT - POLLER STATUS COMMANDS 



:i 
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3.2 POLLER SYSTEM CONTROL COMMANDS (/PCTRL) 

The control commands govern the use of the Poller software package during a Poller occurrence. 
These commands are used to initially TEST the data bases to be used for a live occurrence. Then 
they are used to start, halt, restart, terminate, and/or abort an occurrence of the Poller. Only one 
Poller control command may be issued at a time; if more are issued, an error message will be 
generated. The exception to this rule is that APO may be issued to override an HPO or TPO 
command. 

Operator input of the /PCTRL command causes the following menu of Poller system control com- 
mands to be displayed: 




POLLER SYSTEM CONTROL COMMANDS 

SPO - START POLLER OPERATION 

HPO - HALT POLLER OPERATION 

RPO - RESTART POLLER OPERATION 

TPO - TERMINATE POLLER OPERATION 

APO - ABORT POLLER OPERATION 

TEST - TEST POLLER OPERATION 




2302679-9701 



3-3 
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3.2.1 Start Poller Operation (SPO) 

This command is used to start the Poller operation. Before this command is issued, the user must 
have already generated a complete set of data bases (via the /PCONFG utilities) and tested them 
using the TEST command. The SPO command starts a live occurrence of the Poller and expects 
the information in the data bases it prompts for to be both correct and complete. 

Input of the SPO command generates the following display, prompting the operator for the 
pathnames of the data bases to be used by the Poller: 



START POLLER OPERATION 

POLLER DATABASE PATHNAME: 

TERMINAL DATABASE PATHNAME: 

TERMINAL LIST PATHNAME: 

START UP TIME: NO 



The Poller data base pathname, the terminal data base pathname, and the terminal list pathname 
are the pathnames of the DX10 disk files containing the information to be used by the Poller soft- 
ware to perform the desired polling activities. The network administrator normally provides these 
pathnames to the operator. 
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To start the Poller immediately, accept the default for the prompt START UP TIME (NO) by press- 
ing the RETURN key. If a later start time is desired, key in YES and press the RETURN key. This 
produces the following display of prompts: 



PLEASE ENTER START TIME 

HOURS ( 0-23 ) : 00 
MINUTES (0-59): 00 



The hours and minutes represent the time of day when the Poller will be started, not the time to 
wait before starting the Poller. Execute an SDT command to obtain system time (which the SPO 
command uses) and determine the start time from system time. If the time entered is before the 
current time, the Poller will wait until the next day before starting the polling activities. If an error 
in specifying the time is made, the operator can abort SPO by executing a hard break sequence on 
the terminal which issued the SPO command. The hard break sequence for the 911 VDT consists 
of pressing the blank orange key followed by the CONTROL and X keys. 

The SPO procedure may take a few minutes to complete, depending on the number of terminals in 
the terminal list. But, if the terminal data base is created in the same order as the terminal list, the 
time required to complete the Poller startup (SPO) will be greatly reduced. The terminal is not 
available for other activities until SPO completes. 

After acquiring the specified data bases and successfully completing the start-up procedure, the 
Poller generates a message which displays the occurrence number (run-time ID of the Poller task). 

0000 : POLLER SPO COMPLETE; OCCURRENCE NUMBER IS: >XX 
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The initiating terminal retains the occurrence number in a synonym ($OCC$) which is used as the 
default response for all subsequent operator requests for Poller occurrence number at that 
terminal. 

If the SPO procedure does not complete successfully, an error message will be displayed on the 
Model 91 1 VDT which issued the SPO request. This message will indicate the reason why the SPO 
command failed; additional details on these error messages may be found in Appendix B. 

When tie system is actively polling, all log messages are written directly to the disk file(s) and/or 
devices specified in the Poller data base. These log file(s)/device(s) must be available to the Poller 
when it is started and while it is executing because log data is not spooled to the files/devices. 

3.2.2 Halt Poller Operation (HPO) 

The HPO command is used to suspend all Poller activity after all current terminal sessions have 
been completed. After the Poller is halted, it is possible for the user to modify any of the data 
bases being used by the Poller, with the exception of the terminal list. This command allows the 
user to change entries in the data bases after the Poller has been started, but without terminating 
the Poller. For example, the operator can halt the Poller to add or delete a line to/from the Poller 
data base, or to correct terminal information in the terminal data base, or to modify the commands 
in the activity template or terminal procedure data base. Note that any changes made to the ter- 
minal list data base will be ignored when the Poller is restarted. 

The HPO command cannot complete if a line is in manual mode and has an answer-request 
outstanding (CALL SENT state), or current activity (BUSY). 

The HPO command is not used in normal operations, but rather is used in exceptional cir- 
cumstances. After an HPO command has completed, the Poller can be restarted via the RPO com- 
mand or terminated via the TPO or APO command. 
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The HPO command produces the following prompt: 



HALT POLLER OPERATIONS 

POLLER OCCURRENCE NUMBER: >XX 



After the Poller occurrence number is entered, the display will read as follows: 

46 : POLLER HPO REQUEST INITIATED 

The HPO process could take several minutes to complete depending upon when the command is 
issued during the polling activity. When the request is completed the display will read as follows: 

3500 : POLLER HPO COMPLETE 

If the HPO command does not complete successfully, a Poller error message is displayed on the 
Model 911 VDT which issued the command. This message will indicate the cause of the failure; 
refer to Appendix B for further details on any Poller error. 
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3.2.3 Restart Poller Operation (RPO) 

The RPO command restarts the Poller from a halted state (after an HPO command) or following 
recovery from a system power failure. When the restart procedure is completed, the Poller 
resumes operation with the next terminal in the terminal list. The RPO command produces the 
following prompts: 




RESTART POLLER OPERATIONS 

POLLER OCCURRENCE NUMBER: >XX 
POWER FAILURE?: NO 



To restart the Poller after a system power failure, answer YES to the POWER FAILURE? prompt. 
After you respond to the prompts POLLER OCCURRENCE NUMBER and POWER FAILURE?, the 
display reads as follows: 

FOREGROUND COMMAND EXECUTING 

The display will then change to read as follows: 

47 : POLLER RPO REQUEST INITIATED 

When the normal restart procedure completes successfully, the following message will be 
displayed: 

2A00 : POLLER RPO COMPLETE 
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If the response to POWER FAILURE? was YES, then the RPO completion message will read as 
follows: 

2B00 : POLLER RPO POWER FAILURE COMPLETE 

If the restart procedure does not complete successfully, an error message will be displayed which 
indicates the cause of the failure. Refer to Appendix B for details on the specific messages. If RPO 
fails, the Poller occurrence is left in the halted state so that when the problem that caused RPO to 
fail is corrected, another RPO command may be issued. 



NOTE 

The data being transmitted to or received from the terminals ac- 
tually connected to the Poller at the time of a power failure is 
assumed to be lost. The terminal sessions will be restarted either 
from the beginning of the activity template or from the beginning of 
the interrupted procedure as specified in the PIN command 
(paragraph 5.5). 
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3.2.4 Terminate Poller Operation (TPO) 

This command causes a shutdown of a Poller occurrence after all the current terminal sessions 
have been completed. TPO is the normal command used to shut down the Poller. 

After all polling activity has taken place, and if all lines are in call mode, the Poller will 
automatically execute a TPO to shut itself down. This feature is optional (see PIN command), but 
automatic TPO is enabled in the delivered software. If it is disabled, the operator will always be 
forced to issue a TPO command when the polling activity is completed. 

The TPO command prompts for the Poller occurrence number, checks to ensure that the Poller is 
active, and terminates the Poller when the current terminal sessions are completed. After the TPO 
command is entered, the display will show the following: 



TERMINATE POLLER OPERATION 

POLLER OCCURRENCE NUMBER: >XX 




3-10 



2302679-9701 



Operator Instructions 3.2.4 



When the Poller occurrence number is entered, the display will show: 

48 : POLLER TPO REQUEST INITIATED 

The TPO process can take several minutes to complete depending upon when the command is 
issued during the polling activity. The Poller utilities SPA, RLS, RTS, and SLF are useful for 
monitoring the Poller shutdown process. Note that if a line is in manual mode and has an answer- 
request outstanding (CALL SENT state) or is BUSY, the TPO command cannot complete; the 
manual answer must be resolved and the line disconnected (via the MDISC command), or an ALO 
or APO command must be issued. 

After the TPO command is completed the display will read: 

3100 : POLLER TPO COMPLETE 

If the Poller Master Task is not executing and a TPO request is issued, Poller returns an error 
message; refer to Appendix B for details and possible error recovery. However, if the TPO cannot 
shut down the Poller, no message is returned; monitor the shutdown as described previously to 
determine the status of the shutdown and the problem, if any. If TPO fails to complete, you must 
issue an APO command to shut down the Poller. 
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3.2.5 Abort Poller Operation (APO) 

The APO command is used to abort the Poller activities immediately under exceptional condi- 
tions. APO does not wait for the current terminal sessions to complete. Since all Poller activities 
are abruptly terminated, the APO command is not the recommended means for shutting down the 
Poller. However, if a Poller occurrence has a line in manual mode with an answer-request 
outstanding (CALL SENT state), then APO must be used to terminate that occurrence. Entering 
the APO command produces the following prompts: 



ABORT POLLER OPERATIONS 

POLLER OCCURRENCE NUMBER: >XX 



When the Poller occurrence number is entered, the following message will be displayed: 

49 : POLLER APO REQUEST INITIATED 

After the command is completed the display will read: 

3200 : POLLER APO COMPLETE 

APO will complete successfully, unless the DX10 Intertask Communications fails. If this should 
happen, no APO completion message will be displayed and the Poller will become unoperational; 
only under these circumstances should the PMT task be killed via SCI. (Refer to paragraph 5.2.3 for 
details.) 

3-1 2 2302679-9701 



Operator Instructions 3.2.6 



NOTE 

All data from the already completed sessions remains intact and 
usable; only the data for the sessions aborted is of questionable 
integrity. 

3.2.6 Test Poller Operation (TEST) 

The TEST command is used to verify the validity of all the data bases for a Poller occurrence. The 
TEST command causes the Poller to perform the normal polling activities, except that no data or 
commands are actually transmitted over the communications links. In all other respects, this pro- 
cedure executes exactly like a Start Poller Operation (SPO) command, and therefore requires the 
lines specified in the Poller data base to exist and be available. Under the TEST command the ter- 
minal sessions run very quickly, so the operator may not be able to monitor the progress of short 
sessions. However, the log files are generated as if for a normal Poller occurrence. 

The prompts for the TEST command are as follows: 



[ST POLLER OPERATION 

POLLER DATABASE PATHNAME: 

TERMINAL DATABASE PATHNAME: 

TERMINAL LIST PATHNAME: 
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The Poller data base pathname, the terminal data base pathname, and the terminal list pathname 
are the pathnames of the DX10 files containing the Poller information to be tested. After the 
pathnames are entered, the display will read as follows: 

FOREGROUND COMMAND EXECUTING 

When the TEST startup is completed, the display will read as follows: 

0000 : POLLER TEST COMPLETE; OCCURRENCE NUMBER IS: >XX 

If the TEST procedure fails to complete successfully, an error message will be displayed on the 
Model 91 1 VDT that issued the TEST command indicating the cause of the failure. Refer to Appen- 
dix B for details. 



NOTE 

Under the TEST command, no activity will occur for terminals with 
connection-type answer or on lines in answer mode. 
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3.3 POLLER LINE OPERATION COMMANDS (/PLINE) 

The line operation commands allow the operator to terminate, abort, or restart a particular line 
while the Poller is running. This provides the operator with a means of taking a line out of service 
or changing the characteristics of a line, without halting the Poller. However, after a Poller occur- 
rence is started, a new line (not originally in the Poller data base) cannot be added with these 
commands. 

Operator input of the /PLINE command causes the following menu to be displayed: 



POLLER LINE OPERATION COMMANDS 

SLO - START LINE OPERATION 
TLO - TERMINATE LINE OPERATION 
ALO - ABORT LINE OPERATION 



LI 
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3.3.1 Start Line Operation (SLO) 

This command is used to reactivate a line for use by the Poller after it has been deactivated by TLO 
or ALO. The SLO command can be used by the operator to change the mode or WATS 
characteristics of a line after the Poller has been started. The SLO command prompts are as 
follows: 



START LINE OPERATION 



POLLER OCCURRENCE NUMBER: >XX 
LINE NUMBER: 
LINE MODE: . 
LINE WATS: 



The Poller occurrence referenced by the Poller occurrence number must be active. 

The line referenced by the line number must be contained within the Poller data base being used. 

Valid responses for the line mode are CALL, ANSWER, or MANUAL. 

Valid responses for line WATS and their meanings are: 

Space Direct Distance Dialing (no WATS) 
WATS band (Intrastate) 

1-6 WATS band 1-6 
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After the response to all prompts are entered, the display will show the following: 

4C : POLLER SLO REQUEST INITIATED 

When the request is completed, the display will show the following: 

2800 XXXX: POLLER SLO COMPLETE 
where: 

XXXX is the line restarted (STXX or CMXX). 

If the SLO command fails to complete successfully, an error message will be displayed that in- 
dicates the cause of the failure. Refer to Appendix B for clarification of the error and error recovery 
information. 



NOTE 

Whenever the Poller is started (SPO) or restarted (RPO), the lines 
utilized will return to those characteristics specified in the Poller 
data base file. This means all modifications made to lines after the 
initial startup will be lost if restarted; that is, the Poller data base 
file is not changed by an SLO command. 



3.3.2 Terminate Line Operation (TLO) 

The TLO command is used to shut down a line after the current terminal session is completed; the 
Poller occurrence must be active. If the line is busy, the current terminal session is allowed to 
complete before the line is deactivated. Once the line is deactivated, it may be used for other (non- 
Poller) purposes, or its characteristics may be changed and the line reactivated, via the SLO com- 
mand. When the line is taken out of service, the Poller will continue to run as normal with the re- 
maining line(s). 

If a line is in manual mode with an answer-request outstanding (CALL SENT state) or with a ses- 
sion in progress (BUSY state), a TLO command will not deactivate the line until the answer is 
resolved and the session is disconnected (MDISC); otherwise, an ALO command must be used. 
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The TLO prompts are as follows: 



TERMINATE LINE OPERATION 

POLLER OCCURRENCE NUMBER: >XX 
LINE NUMBER: 



The Poller occurrence referenced by the Poller occurrence number must be active. 

The line referenced by the line number must be contained within the Poller data base being used. 

When the Poller occurrence number and line number are entered, the display will show the 
following: 

4B : POLLER TLO REQUEST INITIATED 

When the line is successfully terminated, the display will show the following: 

2600 XXXX: POLLER TLO COMPLETE 
where: 

XXXX is the line terminated (STXX or CMXX). 

If the TLO command fails to complete successfully, an error message will be displayed which in- 
dicates the cause of the failure. Refer to Appendix B for clarification of the error and error recovery 
information. 
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3.3.3 Abort Line Operation (ALO) 

The ALO command is used to deactivate a line immediately under exceptional conditions while a 
Poller is running. The ALO command shuts down a line without waiting for the terminal session to 
complete. The session is abruptly ended and any data being transmitted/received through this ter- 
minal session should be regarded as incomplete. 

If a line is in manual mode with an answer-request outstanding (CALL SENT state) or with a ses- 
sion in progress (BUSY state), then only an ALO command can deactivate the line. 

The prompts associated with the ALO command are as follows: 



ABORT LINE OPERATION 

POLLER OCCURRENCE NUMBER: 
LINE NUMBER: 



•XX 



2302679-9701 



3-19 



3.3.3 Operator Instructions 



The Poller occurrence referenced by the Poller occurrence number must be active. 

The line referenced by the line number must be contained within the Poller data base being used. 

When the Poller occurrence number and line number are entered, the display will show the 
following: 

4A : POLLER ALO REQUEST INITIATED 

When the abort processing is completed, the display will show the following: 

2300 XXXX: POLLER ALO COM PLETE 
where: 

XXXX is the line aborted (STXX or CMXX). 

If the ALO command fails to complete successfully, an error message will be displayed which in- 
dicates the cause of the failure. Refer to Appendix B for clarification of the error and error recovery 
information. 
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3.4 POLLER MANUAL COMMANDS (/PMANL) 

The Poller manual commands provide the operator with a direct interface to the Poller. These com- 
mands may be used by an operator to manually control a session with a remote terminal on either 
aTTYora3780 line. 

All of the Poller manual commands require that the line on which they will be executed be in 
manual mode. These commands provide the operator with the ability to manually call a remote ter- 
minal, establish a manual line to receive incoming calls from terminals, or to disconnect the ses- 
sion on a manual line. In addition, after the manual session is established, the remaining com- 
mands provide for the transmitting/receiving of files or commands to/from the remote terminal. 

Manual operation of the Poller should not be the normal operating mode. However, the manual 
commands are useful when debugging and testing a terminal session, when trying to isolate a 
communication network problem, and when recovering from errors. As an example, the manual 
call command can be used to initiate terminal sessions when an ACU unit fails. 

When the operator enters /PMANL, the following menu is displayed: 



POLLER MANUAL COMMAND TYPES 



/MTTY - MANUAL TTY COMMANDS 
/M3780 - MANUAL 3730 COMMANDS 



CD 
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The operator selects from these two menus, depending upon whether a manually controlled TTY 
or 3780 line is used. The menus generated by both of these choices are shown below, and the 
various commands are described in the following sections. Some of these commands are the 
same for both TTY and 3780. 



POLLER MANUAL TTY COMMANDS 



MANSR - MANUAL ANSWER 

MBAUD - MANUAL MODIFY BAUD RATE 

MCALL - MANUAL CALL 

MDISC - MANUAL DISCONNECT 

SCMDTTY - MANUAL SEND BMT COMMAND TTY 

SFNCTTY - MANUAL SEND BMT FUNCTION TTY 

SFILTTY - MANUAL SEND FILE TTY 

RBLKTTY - MANUAL RECEIVE FILE BLOCKED TTY 

RCONTTY - MANUAL RECEIVE FILE CONTINUOUS TTY 



[] 
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POLLER MANUAL 3780 COMMANDS 



MANSR - MANUAL ANSWER 
MCALL - MANUAL CALL 
MO ISC - MANUAL DISCONNECT 
SCMD37S0 - MANUAL SEND BMT COMMAND 3780 
SFIL3730 - MANUAL SEND FILE 3780 
RFIL3780 - MANUAL RECEIVE FILE 3730 
CTRL3780 - MANUAL CHANGE 3730 EMULATOR 
DYNAMIC PARAMETER 



CD 



The completion status message from all manual commands includes the status from the 
BMTS-990 package (for TTY lines) or from the 3780 Emulator (for 3780 lines). This status is 
represented as XXXX in the completion messages in the following sections. 
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3.4.1 Manual Answer (MANSR) 

The MANSR command is used to prepare a line in the manual mode for an incoming call from a 
remote terminal. Once executed, the manual answer remains in effect until a call is received or the 
request is cancelled by the operator through an ALO or APO operation. The format of the MANSR 
prompts is as follows: 




MANUAL ANSWER 



POLLER OCCURRENCE NUMBER: 

LINE NUMBER: 

ANSWERBACK: 

ACTIVITY TEMPLATE (Y/N): 



>XX 



NO 
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The POLLER OCCURRENCE NUMBER prompt shows a default value if the Poller execution has 
been initiated (through SPO) from the operator's terminal. 

The line number entered is the line (STXX or CMXX) on which the operator wishes to issue the 
answer. 

The answerback may be specified if the operator knows which terminal will call in or wishes to 
allow only a specific terminal to call in. The Poller assumes that the last three characters of the 
terminal's answerback response is the terminal number, and that this terminal number is con- 
tained in the terminal list being used. If the terminal calls in and the terminal number is not in the 
terminal list, the connection will not be made, an error will be generated and another MANSR com- 
mand will have to be issued. 

The response to the ACTIVITY TEMPLATE(Y/N) prompt depends upon whether the activity 
template for the terminal calling in is to be used or not. If YES is entered the terminal session will 
begin as soon as the connection is made and will run through the entire activity template before 
returning to the operator. If the response to the ACTIVITY TEMPLATE(Y/N) prompt is NO, then it is 
assumed that the Poller operator will perform all functions manually with the terminal. 

When the session is completed, the line is not automatically disconnected. The operator must 
execute a manual disconnect command (MDISC). 

When all inputs are entered, the display will show the following: 

4D : POLLER MANUAL REQUEST INITIATED 

If the operation is completed successfully, the display shows the following: 

1800 XXXX: POLLER MANUAL ANSWER SUCCESSFUL 

If the operation is unsuccessful, an error message appears on the display. The first two hexa- 
decimal digits represent the Poller error, and the third and fourth digits indicate the status of the 
SVC shown as follows: 

1AXX XXXX: POLLER ANSWER; ATTEMPT TO CALL IN FAILED 

If the answer attempt is unsuccessful, the attempt must be repeated. 
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3.4.2 Manual Modify Baud Rate (MBAUD) 

The MBAUD command (TTY only) is used in conjunction with a TTY line, using a communications 
interface card, to set the proper baud rate for the next session. The baud rate change only sets the 
communications controller board in the DS990, and does not affect the modem setting, which 
must be manually changed (if possible). Enter the MBAUD command, when it is required, prior to 
entering MCALL or MANSR. 

The format of the MBAUD command prompts is as follows: 



MANUAL MODIFY BAUD RATE 



POLLER OCCURRENCE NUMBER: >XX 
LINE NUMBER: ST_. 
BAUD RATE: 



The Poller occurrence referenced by the Poller occurrence number must be active. 

The line referenced by the line number must be contained within the Poller data base being used. 

The baud rate can be set to 110, 300, 600, 1200, 2400, 4800, or 9600. 

If the operation is successful the response is: 

1C00 XXXX: POLLER MANUAL MODIFY BAUD SUCCESSFUL 
If the operation is unsuccessful the response is: 

19XX XXXX: POLLER MANUAL MODIFY BAUD UNSUCCESSFUL 
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3.4.3 Manual Call (MCALL) 

The MCALL command is used to call a remote terminal either manually or via an ACU unit (with ap- 
propriate hardware). The format of the prompts is as follows: 



MANUAL CALL 



>xx 



POLLER OCCURRENCE NUMBER: 

LINE NUMBER: 

TELEPHONE NUMBER: 

ANSWERBACK: 

ACTIVITY TEMPLATE (Y/N): NO 

TERMINAL NUMBER: __ 



The Poller occurrence referenced by the Poller occurrence number must be active. 

The line referenced by the line number must be contained within the Poller data base being used. 

If the telephone number is provided, the Poller will attempt to dial the number; if no number is pro- 
vided, the Poller assumes that the operator will manually dial the number and simply waits (about 
one minute) for the line to connect to the terminal. 

If an answerback is entered, it will be compared to the terminal's answerback following connec- 
tion. If the terminal's activity template is to be used, the operator should respond to the ACTIVITY 
TEMPLATE(Y/N) with YES. If not, the Poller assumes that the operator will do all terminal com- 
mands manually. In either case, the operator must do a manual disconnect (MDISC) at the end of 
the session. 
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The operator must enter the three-digit terminal number of the terminal to be called; the terminal 
number must be in the terminal list that was used when the Poller occurrence was started. 

If the manual call operation is successful, the response is: 

1700 XXXX: POLLER MANUAL CALL SUCCESSFUL 
If the manual call command fails to complete successfully, the response is: 

1 BXX XXXX: POLLER MANUAL CALL UNSUCCESSFUL 

3.4.4 Manual Disconnect (MDISC) 

The MDISC command is used to terminate the connection with a terminal on a line in manual 
mode. A MDISC command must be issued at the end of any manual session (MCALL or MANSR) 
before the line or Poller can be terminated (TLO or TPO, respectively). 

The MDISC prompts are shown as follows: 



MANUAL DISCONNECT 

POLLER OCCURRENCE NUMBER: >XX 
LINE NUMBER: 
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The Poller occurrence referenced by the Poller occurrence number must be active. 

The line referenced by the line number must be contained within the Poller data base being used. 

If the manual disconnect is successful, the response is: 

3700 XXXX: POLLER MANUAL DISCONNECT COMPLETE 
If the manual disconnect is unsuccessful, the response is: 

1DXX XXXX: POLLER MANUAL DISCONNECT UNSUCCESSFUL 

3.4.5 Manual Send BMT Command TTY (SCMDTTY) 

The SCMDTTY command (TTY only) is used to send valid commands to a 763/765 BMT while in 
manual mode. The prompts are as follows: 



MANUAL SEND BMT COMMAND TTY 

POLLER OCCURRENCE NUMBER: >XX 
LINE NUMBER: ST_. 
BMT COMMAND: 
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The Poller occurrence referenced by the Poller occurrence number must be active. 

The line referenced by the line number must be contained within the Poller data base being used. 

The BMT COMMAND can be any of the following 763/765 BMT commands: CHANGE or CG, COPY 
or CP, CREATE or CF, DELETE, ERASE, FREE, LOCK, RUN, or EXECUTE or EXE. (Refer to the 
Model 763/765 Bubble Memory Terminals, Operating Instructions; Appendix A). Note however that 
no validity checking is done on the BMT command when entered. The string of characters is sent 
directly to the terminal, which interprets the command and sends back the appropriate response. 

If the manual send operation is successful, the response is: 

2E00 XXXX: POLLER MANUAL SEND SUCCESSFUL 
If the manual send operation is unsuccessful, the response is: 

2FXX XXXX: POLLER MANUAL SEND UNSUCCESSFUL 

3.4.6 Manual Send BMT Function TTY (SFNCTTY) 

The SFNCTTY command is used to send 763/765 BMT functions to a 763/765 BMT while in manual 
mode. Refer to the DX10 Bubble Memory Terminal Support (BMTS-990) User's Guide for descrip- 
tions of functions. The prompts are as follows: 



MANUAL SEND BMT FUNCTION TTY 

POLLER OCCURRENCE NUMBER: >XX 
LINE NUMBER: ST__ 
BMT FUNCTION: 



// 
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The Poller occurrence referenced by the Poller occurrence number must be active. 

The line referenced by the line number must be contained within the Poller data base being used. 

The BMT function can be any valid 763/765 BMT function; however, the input is not validated 
before being sent to the 763/765 BMT. To send multiple functions, enclose the response in paren- 
theses and separate the functions with commas. 

If the manual send operation is successful, the response is: 

2E00 XXXX: POLLER MANUAL SEND SUCCESSFUL 
If the manual send operation is unsuccessful, the response is: 

2FXX XXXX: POLLER MANUAL SEND UNSUCCESSFUL 

3.4.7 Manual Send File TTY (SFILTTY) 

The SFILTTY command (TTY only) is used to send a data file from the DS990 to the 763/765 BMT 
while in manual mode. The prompts are as follows: 



MANUAL SEND FILE TTY 

POLLER OCCURRENCE NUMBER: >XX 
LINE NUMBER: ST_. 
990 FILE ACCESS NAME: 
BMT FILE NAME: 
LINE LENGTH: SO 
APPEND: NO 
GENERATE LRC/SEQ (Y/N): NO 
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The Poller occurrence referenced by the Poller occurrence number must be active. 

The line referenced by the line number must be contained within the Poller data base being used. 

The 990 file access name is the pathname of the DX10 disk file to be sent to the terminal. 

The BMT file name is the name of the file on the 763/765 BMT in which the data is stored. The file 
on the BMT must already exist. However, if no file name is entered, the currently assigned record 
file in the 763/765 BMT is used. 

The line length may be specified for those files which do not have 80 character record length, such 
as TIBOL program files (72) or data files. 

To append the contents of the 990 file to the BMT file specified (or the record file), a YES response 
is entered for the APPEND prompt; otherwise, the receiving file is rewound to the beginning of 
file. 

If the operator wants LRC and sequence number characters to be sent (they will replace the last 
two bytes of the 990 file when transmitted), the response should be YES to the GENERATE 
LRC/SEQ (Y/N) prompt. (Refer to the DX10 Bubble Memory Terminal Support (BMTS-990) User's 
Guide for details.) 

If the manual send file operation is successful, the response is: 

2E00 XXXX: POLLER MANUAL SEND SUCCESSFUL 
If the manual send file operation is unsuccessful, the response is: 

2FXX XXXX: POLLER MANUAL SEND UNSUCCESSFUL 



3-32 2302679-9701 



Operator Instructions 3.4.8 



3.4.8 Manual Receive File Blocked TTY (RBLKTTY) 

The RBLKTTY command (TTY only) is used to receive a data file from a 763/765 BMT while in 
manual mode. The RBLKTTY command is used for blocked data transfers (one record at a time) 
from a BMT terminal. 

The prompts for the RBLKTTY command are as follows: 



MANUAL RECEIVE FILE BLOCKED TTY 

POLLER OCCURRENCE NUMBER: >XX 
LINE NUMBER: ST_. 
990 FILE ACCESS NAME: 
BMT FILE NAME: 
LRC/SEQ CHECK <Y/N>: NO 



The Poller occurrence referenced by the Poller occurrence number must be active. 

The line referenced by the line number must be contained within the Poller data base being used. 

The 990 file access name is the pathname of the DX10 disk file where the received data will be 
stored; if the DX10 file does not exist, it will automatically be created. 

The BMT file name is the name of the BMT file to be transmitted. If no file name is entered, the 
BMT terminal sends the currently defined playback file. 

By entering YES in response to the LRC/SEQ CHECK (Y/N) prompt, The operator can specify that 
the data received is to be checked for proper LRC and sequence numbers. (Refer to the BMTS-990 
User's Guide for details.) 
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If the manual receive file operation is successful, the response is: 

1 E00 XXXX: POLLER MANUAL RECEIVE SUCCESSFUL 
If the manual receive file operation is unsuccessful, the response is: 

1 FXX XXXX: POLLER MANUAL RECEIVE UNSUCCESSFUL 

3.4.9 Manual Receive File Continuous TTY (RCONTTY) 

The RCONTTY command (TTY only) is used to receive a data file from a 763/765 BMT while in 
manual mode. The RCONTTY command is used for continuous data transfers from a 763/765 BMT. 

The prompts for the RCONTTY command are as follows: 



MANUAL RECEIVE FILE CONTINUOUS TTY 

POLLER OCCURRENCE NUMBER: >XX 

LINE NUMBER: ST 

990 FILE ACCESS NAME: 
BMT FILE NAME: 

LRC/SEQ CHECK (Y/N): NO 



I k 



The Poller occurrence referenced by the Poller occurrence number must be active. 

The line referenced by the line number must be contained within the Poller data base being used. 

The 990 file access name is the pathname of the DX10 disk file where the received data will be 
stored; if the DX10 file does not exist, it will automatically be created. 
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The BMT file name is the name of the BMT file to be transmitted. If no file name is entered, the 
BMT terminal sends the currently defined playback file. 

By entering YES in response to the LRC/SEQ CHECK (Y/N) prompt, the operator can specify that 
the data received is to be checked for proper LRC and sequence numbers. (Refer to the BMTS-990 
User's Guide for details.) 

If the manual receive file operation is successful, the response is: 

1 E00 0000: POLLER MANUAL RECEIVE SUCCESSFUL 
If the manual receive file operation is unsuccessful, the response is: 

1 FXX XXXX: POLLER MANUAL RECEIVE UNSUCCESSFUL 

3.4.10 Manual Send BMT Command 3780 (SCMD3780) 

The SCMD3780 command (767/769 only) sends commands to a 767/769 BMT while in manual 
mode. The prompts are as follows: 



MANUAL SEND BMT COMMAND 3780 

POLLER OCCURRENCE NUMBER: >XX 
LINE NUMBER: CM__ 
BMT COMMAND: 
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The Poller occurrence referenced by the Poller occurrence number must be active. 

The line referenced by the line number must be contained within the Poller data base being used. 

The BMT command can be any valid 767/769 BMT command. (Refer to the Model 767/769 Elec- 
tronic Data Terminals, Operating Instructions.) However, no validity checking is done on this BMT 
command; the string of characters is sent directly to the terminal which interprets the command 
and sends back the appropriate response. 

If the manual send operation is successful, the response is: 

2E00 XXXX: POLLER MANUAL SEND SUCCESSFUL 
If the manual send operation is unsuccessful, the response is: 

2FXX XXXX: POLLER MANUAL SEND UNSUCCESSFUL 

3.4.1 1 Manual Send File 3780 (SFIL3780) 

The SFIL3780 command (3780 only) sends files from the DS990 to a 3780 terminal while in manual 
mode. The prompts are as follows: 



MANUAL SEND FILE 3780 

POLLER OCCURRENCE NUMBER: >XX 

LINE NUMBER: CM— 
990 FILE ACCESS NAME: 
3780 TERMINAL FILE NAME: 

TY: OFF 

CE: OFF 

VFC: OFF 
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The Poller occurrence referenced by the Poller occurrence number must be active. 

The line referenced by the line number must be contained within the Poller data base being used. 

The 990 file access name is the pathname of the DX10 disk file to be sent to the terminal. 

The name of the file to receive the data is the 3780 terminal file name. The file must already exist 
on the remote 3780 terminal. If a 3780 terminal file name is not specified, the file will be sent to the 
currently-defined punch file. Note that if the punch file is not defined on the remote 3780 terminal, 
the file transfer will be lost. 

The TY, CE and VFC prompts allow the operator to enable (ON) or disable (OFF) Transparency, 
Compression/Expansion, and Vertical Format Control respectively, when sending a file to the 
3780 terminal. Refer to the DX10 3780 Emulator User's Guide for details. 

If the manual send operation is successful, the response is: 

2E00 XXXX: POLLER MANUAL SEND SUCCESSFUL 
If the manual send operation is unsuccessful, the response is: 

2FXX XXXX: POLLER MANUAL SEND UNSUCCESSFUL 
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3.4.12 Manual Receive File 3780 (RFIL3780) 

The RFIL3780 command (3780 only) receives a data file from a 3780 terminal while in manual mode. 
The RFIL3780 command produces the following prompts: 



MANUAL RECEIVE FILE 37S0 



POLLER OCCURRENCE NUMBER: 


>XX 


LINE NUMBER: 


CM- 


990 FILE ACCESS NAME: 




3780 TERMINAL FILE NAME: 




TRA: 


OFF 


MAP: 


ON 


COM: 


OFF 






The Poller occurrence referenced by the Poller occurrence number must be active. 

The line referenced by the line number must be contained within the Poller data base being used. 

The 990 file access name is the pathname of the DX10 disk file into which the received data is to 
be stored. If the DX10 file does not exist, it will automatically be created. 

The 3780 terminal file name is the name of the file from which the data is to be received. When 
polling a 767/769 BMT, if no 3780 terminal file name is specified, the 990 file access name is 
simply placed on the DX10 3780 receive print queue; no transmission occurs until the operator 

enters the 767/769 BMT command CHA 3780 REA = with the appropriate BMT file name 

specified. (See the SCMD3780 command.) When polling a 990 as the remote 3780 terminal, the 
3780 terminal file name must be specified, or the Poller error (4E00) will be returned. 
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The TRA, MAP, and COM prompts allow the operator to enable (ON) or disable (OFF) transparency, 
ASCII-EBCDIC-ASCII mapping and compression/expansion on the transfer from a 767/769 BMT 
(only). Refer to the 767/769 BMT Systems Manual for details. 

If the manual receive operation is successful, the response is: 

1 E00 XXXX: POLLER MANUAL RECEIVE SUCCESSFUL 
If the manual receive operation is unsuccessful, the response is: 

1FXX XXXX: POLLER MANUAL RECEIVE UNSUCCESSFUL 

3.4.13 Manual Change 3780 Emulator Dynamic Parameter (CTRL3780) 

The CTRL3780 command allows the operator to change some of the dynamic 3780 parameters 
associated with a line in manual mode. This command alters the DX10 3780 Emulator parameters 
in the Poller system. The prompts for the CTRL3780 command are as follows: 



MANUAL CHANGE 3780 EMULATOR DYNAMIC PARAMETER 

POLLER OCCURRENCE NUMBER: >XX 

LINE NUMBER: CM 

DYNAMIC PARAMETER ASSIGNMENT: 



The Poller occurrence referenced by the Poller occurrence number must be active. 

The line referenced by the line number must be contained within the Poller data base being used. 
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The response for the dynamic parameter assignment is a single string from the following: 

TY = ON or OFF 

CE = ON or OFF 

VFC = ON or OFF 

TRAILB = ON or OFF 

SRL = XXX (where XXX may be up to 255) 

RPRRL = XXX (where XXX may be up to 255) 

For further explanation of use of these parameters, refer to the DX10 3780 Emulator User's Guide. 
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3.5 POLLER MEDIUM COMMANDS (/PMEDM) 

The /PMEDM commands provide the operator with a means of transferring DX10 data files to a 
magnetic tape which may then be processed on a host system. 

These commands allow the operator to either write or read an unlabeled ASCII or EBCDIC tape in 
blocked or unblocked format. They also allow for the writing or reading of IBM-standard labeled 
tapes (EBCDIC only) and for generating an IBM standard tape label. These commands are des- 
cribed in detail in the following sections. 

Operator input of the command /PMEDM produces the following menu of Poller medium com- 
mands: 



POLLER MEDIUM COMMANDS 

WDTM - WRITE FROM DISK TO MAGNETIC TAPE 
RMTD - READ FROM MAGNETIC TAPE TO DISK 
WTLT - WRITE TO LABELED TAPE (IBM STANDARD) 
RFLT - READ FROM LABELED TAPE (IBM STANDARD) 
CTH - CREATE TAPE HEADER (IBM STANDARD) 



n 
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3.5.1 Write from Disk to Magnetic Tape (WDTM) 

The WDTM command transfers the contents of a specified DX10 disk file to a magnetic tape in 
unlabeled format. The prompts for WDTM are as follows: 



WRITE FROM DISK TO MAGNETIC TAPE 

INPUT ACCESS NAME: 

OUTPUT DEVICE NAME: MT01 

EBCDIC FORMAT?: NO 

LOGICAL RECORD LENGTH: 30 

BLOCK SIZE: 400 



The input access name is the DX10 disk file containing the data to be stored on magnetic tape. 

The output device name is the magnetic tape unit to which the data is to be written. 

Operator input of YES in response to the EBCDIC FORMAT? prompt causes the ASCII data on the 
disk to be converted to EBCDIC before being written to the tape. 

The block size (not to exceed 4000 bytes) must be a multiple of the logical record length; if the 
maximum is exceeded, the task terminates and an error message is displayed. 

When an end-of-volume (EOV) condition is encountered, the tape is automatically unloaded and 
the operator is prompted for the next tape on which the writing of the data set is to continue. After 
the new tape is loaded, the operator can press any key to continue, except the dollar sign ($) key 
which will cause the task to terminate. 
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When an end-of-volume (EOV) condition is encountered, the tape is automatically unloaded and 
the operator is prompted for the next tape on which the data set is continued. After the new tape is 
loaded, the operator can enter any key to continue, except the dollar sign ($) key which will cause 
the task to terminate. If the task is terminated, the data read from preceding tapes is still intact 
within the output file. 

The Poller tape utilities ensure that all data (including header, trailer and EOFs) are written within 
the boundaries of the reflective strips. If the tape is generated such that data is written past the 
reflective strip (only possible on non-TI990 systems), then that data will be lost when the RMTD 
utility reads the tape. 

3.5.3 Write to IBM Standard Labeled Tape (WTLT) 

The WTLT utility allows the operator to generate a labeled tape which can be processed on host 
systems which support IBM standard tapes. Operator input of the WTLT command produces the 
following prompts: 



WRITE FROM DISK TO IBM STANDARD LABELED MAGNETIC TAPE 




INPUT ACCESS NAME: 
OUTPUT DEVICE NAME: MTOl 
VOLUME SERIAL NUMBER: 
DATA SET IDENTIFIER: 



he input access name is the pathname of the DX10 disk file to be written to tape. The WTLT utility 
ssumes that the magnetic tape has been previously formatted to contain an IBM standard label 
>ee CTH command). The output device name is the magnetic tape unit to which the data is to be 
Titten. 
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If a write ring is not installed on the tape, the task prompts the operator to install one. The operator 
should unload and dismount the tape, install a write ring, mount and reload the tape. To continue, 
the operator can enter any key, except the dollar sign ($) key which will cause the task to 
terminate. 

3.5.2 Read from Magnetic Tape to Disk (RMTD) 

The RMTD command transfers the contents of a magnetic tape file in unlabeled format to a 
specified DX10 disk file. The prompts for RMTD are as follows: 



READ FROM MAGNETIC TAPE TO DISK 

INPUT DEVICE NAME: MT01 

EBCDIC FORMAT?: NO 

LOGICAL RECORD LENGTH: so 

BLOCK SIZE: 400 
OUTPUT ACCESS NAME: 

REPLACE?: NO 



The input device name is the magnetic tape unit from which the data is to be read. 

If the tape contains EBCDIC data, then the response to EBCDIC FORMAT? must be YES to cause 
the EBCDIC data to be converted to ASCII before being written to disk. If NO is entered, the tape is 
assumed to contain ASCII data. 

The logical record length and block size must be known for the tape. The block size must be a 
multiple of the logical record length but must not exceed 4000 bytes. 

The output access name is the pathname of the DX10 disk file where data from the tape will be 
stored. If the file already exists, then the response to REPLACE? must be YES, or the task will ter- 
minate with an error. 
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If the operator enters a volume serial number (up to 6 alphanumerics) and/or a data set identifier 
(up to 17 alphanumerics), the task will check the entries against the corresponding values read 
from the tape. If there is a mismatch, the task terminates and logs an error to the operator. This 
checking procedure does not continue with each subsequent volume in a multivolume environment. 

The task obtains the logical record length and block size from the label on the tape. If the block 
size exceeds 4000 bytes or is not a multiple of the logical record length, the task will terminate 
with an error message. The task automatically sets the block count to zeros; the tape density to 
800 or 1600 bpi; and the tape recording technique to NRZI or PE. Other specific block information 
is also rewritten in the header labels of the first tape regardless of previous settings. 

If an end-of-volume (EOV) condition is encountered, the tape is automatically unloaded and the 
operator is prompted for the next tape on which the data set is to continue. After the new tape is 
loaded, the operator can enter any key to continue, except the dollar sign ($) key which will cause 
the task to terminate. 

On a volume change, the task converts the header labels into trailer labels and inserts the block 
count. The header labels from the first tape are copied to the next tape and the volume sequence 
number is incremented. 

If a write ring is not installed on the tape, the task prompts the operator to install one. The operator 
should unload and dismount the tape, install a write ring, mount and reload the tape. To continue, 
the operator can enter any key, except the dollar sign ($) key which will cause the task to 
terminate. 



2302679-9701 



3-45 



3.5.4 Operator Instructions 



3.5.4 Read from IBM Standard Labeled Tape to Disk (RFLT) 

The RFLT utility allows the operator to transfer data from an IBM-standard labeled tape to a DX10 
disk file. Operator input of the RFLT command produces the following prompts: 





READ FROM IBM STANDARD LABELED MAGNETIC TAPE TO DISK: 



INPUT DEVICE NAME: 

VOLUME SERIAL NUMBER: 

DATA SET IDENTIFIER: 

OUTPUT ACCESS NAME: 

REPLACE? (YES/NO): 



MTOl 



NO 




The input device name is the magnetic tape unit from which the labeled tape data is to be read. 

If the operator enters a volume serial number (up to 6 alphanumerics) and/or a data set identifier 
(up to 17 alphanumerics), then these inputs will be checked against the corresponding informa- 
tion read from the label on the tape. The checking procedure continues with each subsequent 
volume in a multivolume environment. If a mismatch occurs on a subsequent volume, the data 
from the previous volume(s) is intact within the output file. 

The output access name is the pathname of the DX10 disk file to which the data is to be written. 
The system creates the file if the fiJe does not exist. 

The response to the REPLACE (YES/NO) prompt specifies whether or not to overwrite an existing 
file. 

The logical record length and block size are obtained by the task from the labels on the tape. The 
block size (not to exceed 4000 bytes) must be a multiple of the logical record length or the task will 
log an error to the operator and then terminate. 
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When an end-of-volume condition occurs, the tape is automatically unloaded and the operator is 
prompted for the next tape in the data set sequence. After the new tape is loaded, the operator can 
enter any key to continue, except the dollar sign ($) key which will cause the task to terminate. If 
the task is terminated, the data read from preceding tapes is left intact within the output file. 

The Poller tape utilities ensure that all data (including header, trailer and EOFs) are written within 
the boundaries of the reflective strips. Data which is written past the reflective strip (only possible 
on non-TI990 systems) cannot be read by the RFLT utility and will be lost. 

3.5.5 Create IBM Standard Label Tape Header (CTH) 

The CTH utility allows the operator to create a tape header for an IBM standard labeled tape. The 
format of the header for an IBM standard labeled tape is shown in the IBM manual OS Tape Labels. 
A series of prompts input the required data; the data is then written to a DX10 disk file. This DX10 
disk file may then be copied to the beginning of a tape. 

The format of the CTH prompts is as follows: 



CREATE IBM STANDARD LABEL TAPE HEADER 

VOLUME SERIAL NUMBER (1-6): 
OWNER NAME/ ADDRESS (1-10): 
DATA SET IDENTIFIER (1-17): 

VOLUME SEQUENCE NUMBER (4): 0001 

DATA SET SEQUENCE NUMBER (4): 0001 

EXPIRATION DATE (5) CYYDDD3: 99365 

DATA SET SECURITY (1): 

LOGICAL RECORD LENGTH (5): 00030 

BLOCK SIZE (5): 00400 
HEADER LABEL FILE PATHNAME: 

REPLACE: NO 
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The volume serial number is a one to six digit number. The owner name/address is a one to ten 
alphanumeric entry. These two values are written into the VOL1 portion of the tape label. 

The data set identifier is 1 to 17 alphanumerics. The volume sequence number is a four-digit 
number. The data set sequence number is a four-digit number. The expiration date is a five-digit 
date designation with the first two digits being the year and the last three digits being the Julian 
date. The data set security input is a single digit number. These five values are written into the 
HDR1 portion of the tape label. 

The logical record length is a five-digit number. The block size is also a five-digit number but must 
be a multiple of the logical record length and must not exceed 4000 bytes. These two values are 
written into the HDR2 portion of the tape label. 

Finally, the header label file pathname is the pathname of the DX10 disk file into which the tape 
label information is to be written. The response to the prompt REPLACE indicates whether the 
contents of the header label file pathname should be overwritten (if the file already exists). 

After executing the CTH command, rewind a reel of magnetic tape to which the label is to be 
written. Then, execute a Write from Disk to Magnetic Tape (WDTM) command to write the label to 
the tape. Specify EBCDIC format, a logical record length of 80, and a block size of 80 for the WDTM 
command. You can now enter a Write to IBM Standard Labeled Tape (WTLT) command to write the 
tape file. 
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3.6 POLLER STATUS COMMANDS (/PSTAT) 

The /PSTAT commands permit the operator to monitor the status of the poller, either during or 
after its execution. These commands can be used to check for errors and to produce completion 
reports following the Poller occurrence. 

Some of the commands are used to request displays/listings of the status of the lines, the ter- 
minals, or the Poller itself. One task generates a dynamic display of the Poller status as it runs. 

Finally, two other commands are used to produce formatted displays or listings from the raw log 
files. One of these commands generates a live display of the log file information while the Poller is 
running; the other generates a static summary-type report of a log file. 

Operator input of the /PSTAT command produces the following menu: 



POLLER STATUS COMMANDS 



RPS - REQUEST POLLER STATUS 
RLS - REQUEST LINE STATUS 
RTS - REQUEST TERMINAL STATUS 
SPA - SHOW POLLER ACTIVITY 
SLF - SHOW LOG FILE 
LLF - LIST LOG FILE 



C3 
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3.6.1 Request Poller Status (RPS) 

The RPS command generates a display/listing of the overall status of the latest occurrence of the 
Poller. The operator is prompted only for the listing device to receive the status report as shown 
below: 




REQUEST POLLER STATUS 

LISTING DEVICE: 
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The response to the RPS command is a display/listing in the following format: 



REQUEST POLLER STATUS 

OCC.IMO STATE TEST FILES 

>XX ACTIVE PDB: VOLUME. POLLER. PDB 

TDB : VOLUME . POLLER . TDB 
TL: VOLUME. POLLER. TL 





The response terminology is as follows: 

The Poller OCC. NO. is the run-time task ID of the Poller task. 

The Poller STATE may be either ACTIVE, HALTED, or TERMinated. This reflects the results 
of the last executed Poller control command (SPO, HPO, TPO, etc.). 

A T in the TEST column indicates that the Poller occurrence was initiated via the TEST 
command. 

The FILES are those which were defined when the Poller was started. 

When RPS runs, it sets the synonym $OCC$ to the current value of the Poller occurrence number. 
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3.6.2 Request Line Status (RLS) 

The RLS command generates a display/listing of the most recent status of the lines associated 
with an occurrence of the Poller. The RLS command prompts the operator for the Poller occur- 
rence number and a listing device. The Poller occurrence number may default to the current value, 
or may be changed to review the line status from a previous occurrence of the Poller. The listing 
device will be determined by the operator. The prompts are as follows: 



REQUEST LINE STATUS 



POLLER OCCURRENCE NUMBER: >XX 
LISTING DEVICE: 
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The response to the RLS command is a display/listing in the following format: 



REQUEST LINE STATUS 
LINE NO. PROTOCOL 



ST06 
CM02 



OCCURRENCE: >XX 
CONNECTION STATUS 



TTY76S 
3780 



CALL 
CALL 



CALL SENT 
BUSY 



USER 

480 
275 



The response terminology is as follows: 

The response to OCCURRENCE is the run-time ID of the Poller task. 
The PROTOCOL may be either TTY765 (or TTY only) or 3780. 
The line CONNECTION may be CALL, ANSWER, or MANUAL. 
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The line STATUS may be one of the following: 



Line Status 



Meaning 



ACTIVATED 

SERVICE 

CALL SENT 

BUSY 

DISCONNECTED 

DEACT SENT 

DEACTIVATED 



Line being put in service 

Line available 

Call or answer request outstanding (pending) 

Terminal session in progress 

Terminal session being terminated 

Line being taken out of service 

Line unavailable 



The USER is the terminal number of the currently connected terminal, if any. 

3.6.3 Request Terminal Status (RTS) 

The RTS command generates a display/listing of the most recent status of the terminals 
associated with an occurrence of the Poller. The RTS command prompts the operator for the 
Poller occurrence number and a listing device. The occurrence number may default to the current 
value, or may be changed to review the final terminal status from a previous occurrence of the 
Poller. The listing device will be determined by the operator. The prompts are as follows: 




TERMINAL STATUS 

POLLER OCCURRENCE NUMBER: 
LISTING DEVICE: 



>XX 
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The response to the RTS command is a multipage display/listing in the following format: 



REQUEST TERMINAL STATUS 
TERM. NO. PROTOCOL 



OCCURRENCE: >XX 
CONNECTION STATUS 



010 


TTY765 


CALL 


POLLED 


480 


3780 


CALL 


POLLED 


00 1 


TTY765 


CALL 


READY 


333 


TTY765 


ANSWER 


READY 



The response terminology is defined as follows: 

OCCURRENCE is the run-time task ID of the Poller task. 
TERM. NO. is the terminal number. 
PROTOCOL is either TTY765 (or TTY only) or 3780. 
CONNECTION is CALL, ANSWER, or EITHER (call or answer). 
The STATUS may be one of the following: 



Status 

READY 

POLLED 

SUCC.CPLT 

DISC.TERM 

TERM. POLLER 

ABORTED 

UNINITIABLE 



Meaning 

Terminal available for polling 

Terminal currently in polling session 

Terminal session completed successfully 

Terminal session unsuccessful, disconnected by terminal 

Terminal session unsuccessful, disconnected by poller 

Terminal session abnormally terminated 

Poller unable to establish connection with terminal 
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3.6.4 Show Poller Activity (SPA) 

The SPA command generates a display on the requesting Model 91 1 VDT, showing all the current 
information of the polling activities. The information is updated approximately every five seconds, 
depending on system activity. 

If the SPA task determines that the Poller occurrence is in the terminated state, SPA will 
automatically exit. The SPA command may be terminated at any time while it is running by press- 
ing the CMD key. 

The only prompt for the SPA is for the Poller occurrence number, formatted as follows: 




SHOW POLLER ACTIVITY 

POLLER OCCURRENCE NUMBER: >XX 



J 
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Operator Instructions 3.6.4 



POLLER ACTIVITY 



OCCURRENCE: >XX STATE: ACTIVE MM/DD/YY HH:MM:SS 



RESOURCES : PDB : POLLER . DEMO . PDB 
TDB : POLLER . DEMO . TDB 
TL: POLLER. DEMO. TL 



LINE # 


NAME 


1 


ST09 


2 


ST12 


3 


STIO 



PROTOCOL CONNECTION STATUS 
TTY765 CALL 
TTY765 ANSWER 
TTY765 MANUAL 



TERMINAL 
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The response terminology is as follows: 

The Poller OCCURRENCE is the run-time task ID of the Poller task. 

The RESOURCES are those files which were defined when the poller was started. 

The Poller STATE is reported as ACTIVE, HALTED or TERMinated. 

The PROTOCOL may be either TTY765 (or TTY only) or 3780. 

The line CONNECTION may be either CALL, ANSWER, or MANUAL. 

The line STATUS may be one of the following: 

Line Status Meaning 

ACTIVATED Line being put in service 

SERVICE Line available 

CALL SENT Call or answer request outstanding (pending) 

BUSY Terminal session in progress 

DISCONNECTED Terminal session being terminated 

DEACT SENT Line being taken out of service 

DEACTIVATED Line unavailable 

TERMINAL is the terminal number of the currently connected terminal, if any. 
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3.6.5 Show Log File (SLF) 

The SLF command allows the operator to generate a live formatted display from the contents of 
any Poller log file as the*file is being generated by the Poller. The report is continuously scrolled 
onto the screen of the requesting Model 911 VDT as the information is written into the log file. 
Therefore, the SLF utility is intended to be run while the Poller is executing. 

When the Poller occurrence is terminated, the SLF utility will automatically terminate. The 
operator may also terminate the SLF utility at any time by pressing the CMD key. 

The only prompt is for the log file pathname. The output goes to the requesting terminal and is 
displayed in the TTY mode. The prompt is formatted as follows: 



SHOW LOG FILE 

LOG FILE PATHNAME: 
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The following is an example SLF display of a Poller log file: 





■^'■'^^ ' 


:■:>■:-:■>; ■■ yyy ■;.■:■:■:■:■:■:•:•'■ 





'.::..::::." 


■■■'•SMiii^'^'^''''-'' 


■ ■::■:■:■■' 




f 








1 




'■:':-;■[ 


ACT-LINE 




ST 18 






■:■;■:■ 


:>:;:. 


ACT-LINE 




CMOl 








M 


0000 : 


POLLER 


SPO COMPLETE; 


OCCURRENCE NUMBER IS: >1C 






; s 


ANSWER 




ST 18 001 


LOR I 001 






>& 


SEND-CMD 




ST 18 001 


FREE DATA IN 






1! 


SEND-CMD 
SEND-CMD 
SEND-FILE 
♦SUCCESSFUL 




ST 18 001 
ST 18 001 
ST 18 001 
ST 18 001 


DELETE DATA IN 

CREATE DATA IN L 10 80 

.P0L.F1 








♦USER STATS 
DISCONNECT 




ST 18 001 
ST 18 


ST=14:55:22 END=14:55 


45 CALLS=00 


1 




♦LINE STATS 
DEACT-LN 




CMOl 3780 
CMO 1 


TOT=000:00:00 AT= 


CP= UN= 




: ss 


2600 CMO 1 : 


POLLER 


TLO COMPLETE 








ivS 


ACT-LINE 




CMOl 








: : :'! : : ; 


2800 CMOl: 


POLLER 


SLO COMPLETE 










CALL 


1 009 


CMOl 002 


BMT002 








1B00 1009: 


POLLER 


MANUAL CALL UN 


SUCCESSFUL 








CALL 


1 009 


CMOl 002 


BMT002 




;?;! 


£* 


1B00 1009: 


POLLER 


MANUAL CALL UN 


SUCCESSFUL 




Wi 




♦LINE STATS 




CMO 1 3780 


TOT=000:00:00 AT= 2 


CP= UN= 


&:■: 


S': : l 


DEACT-LN 




CMOl 










2600 CMOl: 


POLLER 


TLO COMPLETE 






■'■::'. 


:•::;; 


ACT-LINE 




CMOl 








11 


2800 CMO 1 : 


POLLER 


SLO COMPLETE 




J 


1 
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3.6.6 List Log File (LLF) 

The LLF command allows the operator to generate a formatted report from the raw contents of any 
Poller log file. The report may be output to a printer (LPxx) or displayed on a Model 91 1 VDT, where 
it can be viewed via the F1 and F2 function keys. 

The only prompts are for the log file pathname and the listing access name, formatted as follows: 



LIST LOG FILE 

LOG FILE PATHNAME: 
LISTING ACCESS NAME: 
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The log file pathname is the pathname of the DX10 disk file which contains the log information 
which is to be formatted. If the listing access name is left unspecified, the report will be output to 
the screen of the Model 911 VDT which issued the LLF request. 

The following is an example LLF report of a Poller log file: 



10/02 /SI 


LIST 


LOG FILE 


: .POL. 


TL 


OU 




PAGE i 


COMMAND 


ERROR 


LINE 


USER 




DATA 






ACT-LINE 




ST 18 












ACT-LINE 




CMOl 












0000 • 


POLLER 


SPO COMPLETE; 


OC 


CURRENCE NUMBER IS: ; 


>1C 




ANSWER 




ST18 


00 1 




LOR I 001 






SEND-CMD 




ST IS 


00 1 




FREE DATA IN 






SEND-CMD 




ST1S 


001 




DELETE DATA IN 






SEND-CMD 




ST 18 


001 




CREATE DATA IN L 10 : 


30 




SEND-FILE 




ST 18 


001 




.P0L.F1 






♦SUCCESSFUL 




ST IS 


00 1 










♦USER STATS 




ST 18 


001 




ST=14:55."22 END- 14 


:55:45 


CALLS=00 


DISCONNECT 




ST 18 












♦LINE STATS 




CMOl 


3780 




TOT=000 : 00 : 00 AT= 


CP= 


UN= 


DEACT-LN 




CMOl 












2600 CMOl: 


POLLER 


TLO COMPLETE 










ACT-LINE 




CMOl 












2S00 CMOl: 


POLLER 


SLO COMPLETE 










CALL 


1009 


CMOl 


002 




BMT002 






1B00 1009: 


POLLER 


MANUAL CALL UNS 


;uc 


CESSFUL 






CALL 


1009 


CMOl 


002 




BMT002 






1B00 1009: 


POLLER 


MANUAL Ci 


ALL UNS 


SUCCESSFUL 






♦LINE STATS 




CMOl 


3780 




TOT=000 : 00 : 00 AT= 


2 CP= 


UN= 


DEACT-LN 




CMOl 












2600 CMOl: 


POLLER 


TLO COMPLETE 










ACT-LINE 




CMOl 












2S00 CMOl: 


POLLER 


SLO COMPLETE 
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4.1 CONFIGURATION MANAGEMENT UTILITIES (/PCONFG) 

The network administrator uses the Poller configuration management utilities to create and main- 
tain the data bases required for Poller operations. These utilities are accessed directly through the 
System Command Interpreter (SCI). 

There are a minimum of five different data bases which must be created prior to performing an 
SPO or TEST command to begin Poller operation. The five types of files required are a terminal list 
(TL), terminal data base (TDB), Poller data base (PDB), at least one activity template (AT) data base, 
and at least one terminal procedure (TP) data base. Each of these data bases should be created 
and modified only through the utilities provided with the Poller; the DX10 Text Editor should not 
be used. 

The relationship of these data bases to the Poller modules is shown in Figure 4-1. 

4.1 .1 Relationships Between Data Bases 

It is important that the network administrator understand the information conveyed in each data 
base, as well as the relationships that exist among them. The following paragraphs present an 
overview; additional specific details are given in subsequent sections. 

The resources (more specifically, the lines) used during the polling activity are specified in the 
Poller data base. An STxx-type device designates that TTY protocol (via the BMTS-990 package) is 
to be used on the line; a CMxx-type device designates that the 3780 protocol (via the DX3780 
Emulator) is to be used. These devices must be included in the DX10 system via system genera- 
tion (sysgen) before the Poller is started. A minimum of one resource is necessary for any polling 
activity. However, more resources should result in greater polling throughput. Note that the 
number of resources specified in the Poller data base must not exceed the maximum number pro- 
vided for in the Poller; refer to the PIN command (paragraph 5.5) for details. 

A Poller data base can contain a mixture of both STxx and CMxx lines. The mode of operation for 
each line must be defined as either call, answer, or manual. A line in the call mode is used to call 
terminals. A line in the answer mode is used by terminals that call the Poller. A line in the manual 
mode is used for terminal sessions that are manually controlled. The mode of the lines is depen- 
dent on the user's network configuration and communications hardware; that is, if auto-call hard- 
ware is available, then call lines are used; however, if the remote terminals are provided with 
originate-only modems, then answer lines must be used. 

The terminal list contains a list of three-digit terminal numbers and defines the terminals that can 
participate in the polling activity. Only the terminals in the terminal list can be called by or call into 
the Poller. The terminal data base file contains entries for all the terminals in the terminal list; the 
terminal data base may also contain entries for terminals not found in the terminal list. 
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TERMINAL 
LIST 



OPERATOR 



/POPER 
COMMANDS 



POLLER 
OPERATION 
UTILITIES 



ACTIVITY 
TEMPLATE 



TERMINAL 

PROCEDURE 

DATABASE 



POLL 

MASTER 

TASK 



ITC QUEUE 
AREA 



PRESENTATION SERVICES TASK(S) 



2280986 



COMMUNICATION SUBSYSTEM(S) 



POLLER 
DATABASE 



ERROR LOG 
TASK 



LOG DEVICES/FILES 



Figure 4-1. Poller Data Structures 
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A terminal data base entry contains the attributes that are associated with a particular terminal. 
The most important attribute in the terminal data base entry is the connection type (call, answer, 
or either) for the terminal. A terminal that can either call or be called by the Poller is connection 
type call. A terminal that calls the Poller is connection type answer. A terminal that can either call 
or be called by the Poller is connection type either. The type of connection associated with a ter- 
minal is defined by the network administrator based on the system objectives as well as the 
physical capabilities of the modem being used in conjunction with the terminal. 

It is important to note the relationship that exists between a terminal is connection type and a 
resource is mode of operation. If a terminal connection type is call, then the Poller is expected to 
call the terminal; in order to do this, a line whose mode of operation is call must be designated in 
the Poller data base. Likewise, in order for a terminal to call into the Poller, a line must be provided 
whose mode of operation is answer. Also, since lines are defined as supporting either TTY or 3780 
protocol, the protocol used by the terminal, as defined in its terminal data base entry, must match 
the protocol used by the line, as defined in the Poller data base. In addition, the modem-type and 
WATS band associated with the terminal must correspond to the same values for a line in the 
Poller data base. Otherwise, if these four criteria are not met, the terminal will not be polled. 

If all the terminals within the terminal list have a connection type of call (or either), then the order 
of the list defines the order in which the Poller will attempt to call the terminals. The number of ter- 
minals that can be polled concurrently depends on the number of lines in call mode. When a line 
completes a terminal session, the next terminal in the terminal list, whose characteristics match 
those of the available line, is the terminal selected for polling. Before beginning a session, the 
Poller checks that the terminal has not already had a successful session (if connection type is 
either the terminal may have called in); if it has already completed the session, then the terminal is 
skipped. Any terminals with a connection type of answer are skipped when the Poller is deter- 
mining which terminal to call next. 

A line defined in the Poller data base as manual is ignored by the Poller unless the operator enters 
a manual command for that line. Lines in manual mode are not expected to be used in the normal 
operating environment. A manual line should only be used in exceptional conditions, for example: 
if auto-call hardware failed; when attempting to send/retrieve a file that was not transmitted 
automatically; or when trying to resolve a communications problem. A terminal session is initiated 
on manual lines by using the MCALL or MANSR command. 

Once a successful connection is made between the Poller and the remote terminal, the Poller 
determines what actions to perform by accessing the activity template file associated with the ter- 
minal, as specified in the terminal data base. The exception is when the line is in manual mode 
and the operator chooses not to use the activity template. 
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An activity template file contains a generic description of the activity that is to occur when polling 
a terminal. Each terminal must have a corresponding activity template file; however, activity 
templates may be shared by several terminals. In some user applications, it is possible that all ter- 
minals will use the same activity template, but this is by no means a requirement. Regardless, the 
activity template associated with each terminal is specified in the terminal entry in the terminal 
data base. 

Activity templates specify the names of the logical procedures that are to be performed with the 
terminal; the exact definitions of these procedures are resolved in a terminal procedure data base. 
The terminal procedure data base to be used in resolving the logical procedures is specified in the 
first command of the activity template. After this first terminal procedure data base is defined, the 
network administrator may redefine, at his discretion, the terminal procedure data base to be used 
to resolve subsequent logical procedures within the activity template. However, a single terminal 
procedure data base may contain the definitions for all logical procedures in a particular activity 
template or even for all activity templates in the system. 

The procedures contained in the terminal procedure data base are composed of Poller keywords 
and specific terminal commands. These keywords and commands dictate the exact action to take 
place between the Poller and the remote terminal. Terminal procedure data bases, like activity 
template data bases, are sharable between terminals. 

4.1.2 Overview of Poller Error Handling 

Upon completing the execution of a command within the terminal procedure, the command and 
information relevant to the command is logged by the Poller via the ERRLOG task. The relevant in- 
formation includes the completion status of the command, the terminal number, the line being 
used, and command-specific data. 

The ERRLOG task can categorize command completions and other related information into one of 
six types of log events; these are ABORTS, NORMALS, ERRORS, STATISTICS, UNINITIABLES, 
and ALL. Each type of log event can be logged to a separate file and/or device. In the Poller data 
base, the network administrator specifies which log events to log and specifies either a DX10 disk 
file pathname or device name for each. You should not attempt to log more than one event type to 
the same file or device because unpredictable results may be obtained. However, you can log one 
event type to more than one file or device. 

In addition to command completions being logged, whenever any Poller operation, such as SPO, 
is completed, a message is logged to reflect the completion. This includes the completion of all 
manual commands. If the command completes without error, it is logged only to the ALL log file or 
device. If an error occurs, the completion is logged to both the ERRORS and ALL log file(s) and/or 
device(s). 
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The event type ABORTS includes all aborted sessions, whether performed by the operator or the 
Poller due to an error. 

Event type NORMALS includes all terminal sessions which completed successfully. 

Event type UNINITIABLES includes ail unsuccessful connections, regardless of whether the 
Poller failed in an attempt to call the terminal, or a terminal failed in an attempt to call in to the 
Poller, or if the ABMs did not compare; manual call and answer failures are also included. 

Event type STATISTICS includes both the terminal and line statistics. Upon completion of a ter- 
minal session, starting and completion times are logged with the terminal number and the line 
used for the session. In addition, if the Poller called the terminal, the number of calls required are 
logged. Whenever a line is deactivated (by HPO, TPO, APO, TLO, or ALO), statistics for that line are 
logged; these include the total amount of time the line was active (doing terminal sessions), the 
number of attempted sessions on the line (both successful and unsuccessful), the number of ses- 
sions completed successfully, and the number of uninitiable sessions that were attempted on the 
line. The total number of sessions attempted minus the successful and uninitiable sessions 
yields the number of aborted sessions on the line. Whenever the line is started or restarted (via 
SPO, TEST, RPO, SLO), these counters are reset to zero. 

Event type ERRORS includes all commands that completed with a nonzero status. Since the 
Poller receives error status back from many sources, it is sometimes difficult to interpret the error 
code. If the error occurs on a TTY line, the BMTS-990 documentation should be consulted first. If 
an error occurs on a 3780 line, the error most often is from the DX10 3780 Emulator, and that 
documentation should be consulted first. If the error is not found in the appropriate manual (by 
protocol) and if the first two digits of the four-digit error code are nonzero, you should determine 
whether the error is a Poller error by consulting Appendix B of this manual. If the first two digits 
are zero, but the last two are nonzero, then the error may have come directly from the terminal 
being polled. Lastly, and most rarely, if the error code still cannot be located, it should be treated 
as DX10 SVC error code, and the DX10 manuals referenced. Refer to Appendix B of this manual for 
additional information on isolating errors. 

Event type ALL includes all of the above event types. The ALL log is most useful since it is a 
chronological listing of the completion of all commands as well as Poller messages. Whenever 
any data is logged to a specific log file, it is also logged to the ALL log, if one is provided. 
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4.1 .3 Accessing the Poller Configuration Commands 

When the operator inputs the /PCONFG command, a display is generated that contains a menu of 
the various types of Poller configuration commands available. The display contains the names of 
submenus for the terminal list, terminal data base, terminal procedure, activity template, and 
Poller data base edit utilities. The menu also displays the commands for deleting, printing, and 
showing a particular Poller data structure (file); these commands are analogous to the DX10 com- 
mands Delete File (DF), Print File (PF), and Show File (SF) and are included so that the network 
administrator can tailor these procedures to the specific requirements of his system. 

The menu of the Poller configuration management commands is as follows: 



POLLER CONFIGURATION UTILITIES 



/TL - TERMINAL LIST EDIT 
/TD - TERMINAL DATABASE EDIT 
/TP - TERMINAL PROCEDURE EDIT 
/AT - ACTIVITY TEMPLATE EDIT 
/PD - POLLER DATABASE EDIT 
DDS - DELETE DATA STRUCTURE 
PDS - PRINT DATA STRUCTURE 
SDS - SHOW DATA STRUCTURE 



CD 



NOTE 

Any file currently being used by an active occurrence of the Poller 
cannot be modified. 
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4.2 TERMINAL LIST EDIT UTILITIES (/TL) 

The terminal list utilities create and modify a terminal list. The significance of a terminal list file is 
that it defines which terminals can have an activity session with the Poller. The pathname of a ter- 
minal list is required when the Poller is started, via the SPO or TEST commands. 

If each terminal in the terminal list is to be called, the Poller attempts to call the terminals in the 
order of the terminal list. 

The terminal list utilities allow a terminal number to appear more than once in the terminal list. If 
the terminal is to be called by the Poller, multiple entries cause the terminal to be called more than 
once; this may cause previously transmitted or received data to be sent again or overwritten 
depending on the activities performed. 

When you enter the /TL command the following menu of terminal list commands appears: 



TERMINAL LIST EDIT UTILITIES 



CTL - CREATE TERMINAL LIST 
MTL - MODIFY TERMINAL LIST 
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4.2.1 Create Terminal List (CTL) 

The CTL utility allows you to create a terminal list file. The utility prompts for a terminal number 
and an optionally associated comment (maximum 53 characters). 

The CTL utility then displays the MORE prompt. If the response is YES, the utility again prompts 
for a terminal number and comment. This continues until you enter NO in response to the prompt 
MORE. 

The CTL then displays the prompts TERMINAL LIST PATHNAME and REPLACE. The terminal list 
pathname is the DX10 disk file where the entered data is to be stored. The response to REPLACE 
specifies whether to replace an existing file. The CTL utility cannot replace a file that is currently 
in use. 

The format of the CTL prompts is as follows: 



CREATE TERMINAL LIST 



TERMINAL NUMBER: 
COMMENT : 



When the terminal list file is successfully created, the CTL program exits and the Poller menu 
appears. If the file creation is not successful, a standard DX10 error message is presented. The 
cause and correction of the error are found in of the 0X70 Operating System Error Reporting and 
Recovery Manual, Volume VI. 
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CREATE TERMINAL LIST 



MORE: YES 
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CREATE TERMINAL LIST 

TERMINAL LIST PATHNAME: 

REPLACE: NO 
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4.2.2 Modify Terminal List (MTL) 

This command allows you to modify a terminal list by means of add, delete, or change functions. 
The first prompt is for the terminal list pathname; this is the DX10 pathname of the file that con- 
tains the terminal list data. The program then verifies that the file exists and is not currently in use. 
The format of the MTL prompts are as follows: 



MODIFY TERMINAL LIST 

TERMINAL LIST PATHNAME: 



When you select the ADD function, MTL prompts for the terminal number (three digits), an op- 
tionally associated comment (maximum 53 characters), and an existing terminal number (already 
in the terminal list). The terminal number and comment are placed in the list before the specified 
terminal. If no terminal is specified, then the new entry is placed at the end of the terminal list. 

When you select the DELETE function, only the terminal number is entered to delete the terminal 
from the terminal list. The function deletes the first terminal on the list with the specified terminal 
number. 

When you select the CHANGE function, the MTL task prompts for the terminal number, checks 
the terminal list for an entry for that terminal, and (if found) displays the terminal number and com- 
ment to the operator for modification. When modified, the new data is written back to the file. 
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MODIFY TERMINAL LIST 

ADD/DELETE/ CHANGE TERMINAL: ADD 
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MODIFY TERMINAL LIST 



TERMINAL NUMBER: 

COMMENT : 

INSERT BEFORE TERMINAL: 




J 
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MODIFY TERMINAL LIST 



MORE: YES 
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After performing each function, the prompt MORE appears. If the reply is YES, the MTL utility 
allows you to perform another add, delete,-or change function. With a response of NO, the utility 
closes the terminal list file and returns to the Poller menu. 

4.2.3 Terminal List Example 

The following is an example of a terminal list. In this example, only these six terminals can have 
activity sessions with the Poller. If each terminal in this terminal list is in the call mode, the Poller 
attempts to call the terminals in the order of the terminal list. 




* THIS IS THE 763 IN STORE A- 19427 

* FREDDIE'S MEAT MARKET 

* TERMINAL IN TASTING ROOM AT JOHN'S WINER 



* NO COMMENT 
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4.3 TERMINAL DATA BASE EDIT UTILITIES (/TD) 

The terminal data base utilities create and modify a terminal data base file. Each terminal 
specifed in the terminal list must have a corresponding entry in the terminal data base. The 
pathname of a terminal data base is required when the Poller is started via the SPO or TEST 
commands. 

A terminal data base entry describes all the characteristics of the corresponding terminal. The 
characteristics of a terminal must be compatible with the characteristics of at least one line de- 
fined in the Poller data base file in order for the terminal to have an activity session with the Poller. 
In particular, the characteristics that must be compatible are the connection type of the terminal 
and the mode of the line, the protocol type, the WATS band, and the modem type. 

Operator input of the /TD command causes the following menu of terminal data base commands 
to be displayed: 



r*~^ 



TERMINAL DATABASE EDIT UTILITIES 

CTD - CREATE TERMINAL DATABASE 
MTD - MODIFY TERMINAL DATABASE 




The next two sections describe the CTD and MTD commands followed by a detailed description of 
each of the terminal data base keywords. 
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4.3.1 Create Terminal Data Base (CTD) 

The CTD utility creates a terminal data base. The utility first creates a temporary file, then prompts 
for the data required for a terminal data base entry as follows: 



•:■:•:.. 






f "\ 


m 


: 


CREATE TERMINAL DATABASE 


¥;:?: 




TERMINAL NUMBER 








CONNECTION 








ANSWERBACK 








PRIMARY PHONE 








AUX PHONE 1 








AUX PHONE 2 








RETRY COUNT 


3 






WAIT TIME. 


120 


m 


: 


PROTOCOL NAME: 








BAUD RATE: 


1200 






TERMINAL TYPE: 


763 




: 


WATS BAND: 








MODEM TYPE: 






i 


ACTIVITY TEMPLATE PATHNAME: 






H 
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The CTD utility then prompts for more entries as follows: 



CREATE TERMINAL DATABASE 
MORE: YES 
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If the response is YES, the utility prompts for another terminal entry. When you enter NO, the 
utility displays the TERMINAL DATABASE PATHNAME and REPLACE prompts. The prompts are 
formatted as follows: 



CREATE TERMINAL DATABASE 

TERMINAL DATABASE PATHNAME: 

REPLACE: NO 



The terminal data base pathname is the pathname of the DX10 disk file in which the terminal data 
base information is to be stored. The response to REPLACE specifies whether to replace an 
existing file. The CTD utility cannot replace a file that is currently in use. 
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4.3.2 Modify Terminal Data Base (MTD) 

This command allows you to modify a terminal data base file by adding, deleting, or changing en- 
tries in an existing file. If the file does not exist, an error is returned. A terminal data base which is 
currently in use cannot be modified. The utility then prompts to determine whether a terminal data 
base entry is to be added, deleted, or changed by displaying the following: 




MODIFY TERMINAL DATABASE 

TERMINAL DATABASE PATHNAME: 
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MODIFY TERMINAL DATABASE 

ADD/DELETED/CHANGE/QUIT: ADD 
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If a terminal data base entry is to be deleted, the MTD utility prompts for the terminal number. The 
terminal data base entry corresponding to the terminal number provided is then deleted. 




MODIFY TERMINAL DATABASE 

TERMINAL NUMBER: 



If a terminal data base entry is to be added, the utility prompts for the keywords as shown in the 
create terminal data base entry format. 

If a terminal data base entry is to be changed, the utility displays the terminal entry data in the for- 
mat previously shown for create terminal data base, but with the defaults set to the current value 
of each field as it appears in the terminal data base. The operator may then examine the value of 
each keyword and make changes to be incorporated in the file. 

When each ADD, DELETE, or CHANGE function is completed, the MTD utility prompts with 
MORE. If the response is YES, the operator is prompted again to perform an ADD, DELETE, 
CHANGE or QUIT function. If the response to MORE is NO, the MTD will terminate; the QUIT func- 
tion also terminates MTD. 
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4.3.3 Terminal Data Base Keywords 

The following keywords are defined for each terminal data base entry: 

Terminal Connection 

Type Meaning 

CALL Poller will call terminal 

ANSWER Terminal will call into the Poller 

EITHER Terminal can be called or call in 

If the terminal connection type is ANSWER, then the prompts for phone number, retry count, 
and wait time are skipped since these are not required for answer-mode operation. 

ANSWERBACK 

The value of the answerback, if specified, is compared to the ABM (or terminal ID) re- 
ceived from the terminal and must match exactly or else the session is terminated and 
the line is disconnected. No control characters may be included in this answerback 
value. If the terminal is to dial into the Poller, the last three characters of the terminal's 
ABM must be the terminal number. The Poller uses these last three digits to determine 
whether the terminal number is in the terminal list, whether the terminal has called in 
previously, and whether it can have an activity session with the Poller. 

PHONE NUMBERS 

Up to three phone numbers may be presented for each terminal. The numbers are used 
in the specified order by the Poller to establish a connection with the terminal. The 
phone numbers may include the special symbols: equal sign ( = ), asterisk (*), pound 
sign (#), and minus sign (-), as supported by the BMTS-990 package or the DX10 3780 
Emulator. A maximum of 40 digits and symbols are accepted. For 3780, no special sym- 
bols are required to dial long-distance; that is, only the digits of the phone number 
should be used. 

RETRY COUNT 

This value specifies the number of times to reattempt to establish a connection with the 
terminal using a particular phone number (in addition to the single initial attempt). 

WAIT TIME 

This value specifies the duration of time (in seconds) to wait before reattempting to 
establish a connection with the terminal in the event a previous call failed. 

PROTOCOL 

The protocol through which the terminal communicates with the Poller: TTY765 (or TTY) 
or 3780. There is no distinction made between TTY765 and TTY. 
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BAUD RATE 

Baud rate is the speed at which the terminal communicates: generally 300 or 1200 for 
TTY protocol. Valid responses are 110, 300, 600, 1200, 2400, 4800, 9600 and FFFF (see 
BMTS-990 documentation for details). The Poller can use this baud rate to change only 
the speed on the communications interface (COMMIF) card; the setting does not affect 
the baud rate of the modem or the remote terminal. The BAUD RATE keyword applies 
only to TTY protocol. 

TERMINAL TYPE 

Valid responses are 763, 765, 767, 769, and 990. The 763 and 765 are TTY-type terminals; 
the 767, 769 and 990 are 3780-type terminals. 

WATS BAND 

WATS band value is used to match a resource (line) to the terminal which may be called 
using that resource. Acceptable values are as follows: 

Value Meaning 

blank DDD dialing 

Intrastate WATS 

1-6 Interstate WATS bands 

Lines with or (blank) WATS designations are always matched exactly to terminals with 
the same designation. Lines with WATS bands 1-6 may be matched exactly or may call 
any terminal with less than or equal WATS designations. This is an option selected 
through the PIN utility (see paragraph 5.5). WATS may be used to restrict the use of a 
line to only a subset of the terminals. 

MODEM TYPE 

This specifies the type of modem associated with the terminal. Zero through four 
characters may be used to specify the modem type. The modem type for the terminal, as 
specified in the terminal data base, must exactly match the modem type for the line, as 
specified in the Poller data base. Although the modem types may be compatible, such 
as Vadic 3451 and Bell 212A, the Poller will not consider these to be compatible since 
the types do not match exactly. Therefore, some description must be determined which 
can be used for both the terminal and the line modem types. Note that the MODEM 
TYPE is an optional prompt, and that a nonspecified terminal modem type is assumed to 
match a nonspecified line modem type. 

ACTIVITY TEMPLATE PATHNAME 

This entry specifies the DX10 pathname of the activity template to be used during the 
polling activity. DX10 synonyms are not supported in this pathname designation. 
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4.3.4 Terminal Data Base Example 

The following is an example of an entry in a terminal data base: 

023 ##* TERMINAL DATA BASE! ENTRY ### 

l::~ I T H E R *■ c o n n * c t i o n t y p e 

FREDDIES023 # answerback 

'5 5 5 •- 1 2 i 2 * F- r i rn a r v p h o n e i* 

* aux phone #1 
•a- aux phone #2 

2 * r e t r y c o u n t 

3 * wa i t t i me 

TTY765 •«• protocol type 

1200 # baud rate 

765 # terminal t ype 

# wats 1 ine 

212A * modem type 

VOLJ... DATABASE. AT # activity template f i 



In the above example, the terminal number is 023 and the terminal can be called by the Poller or 
may call in (EITHER). The answerback for the terminal is FREDDIES023; note the terminal number 
on the end of the answerback. Only one phone number is provided for the terminal. If the initial at- 
tempt to connect to the terminal fails, the Poller software will retry 2 times, waiting 30 seconds 
between each attempt. The terminal uses TTY protocol and is set up to communicate at 1200 
baud. The terminal is a 765 and communication with the terminal is to be via WATS band 0. The 
modem associated with the terminal is a 212A; presumably a Bell 212A-compatible modem. Once 
the connection is established with the terminal, the file VOL1.DATABASE.AT is to be used as the 
activity template for the session with the terminal. 
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4.4 TERMINAL PROCEDURE EDIT COMMANDS (/TP) 

A terminal procedure data base is made up of one or more procedures (PROCs). Each PROC must 
start with a unique PROC name (1 to 8 characters long with the first character an alphabetic), 
followed by the string = BEGIN; this designates the start of the PROC. On subsequent lines, the 
user enters the various terminal procedure statements to perform the desired terminal function(s). 
The last statement (line) of each PROC is the keyword END. 

Terminal procedure statements cannot be longer than a single line. Comments may be included in 
the file by preceding the text of the comment with an asterisk. Lines containing only comments 
are allowed. Blank lines may be used within a procedure and as delimiters between PROCs. 

Operator input of /TP command displays a menu of terminal procedure commands. The various 
terminal procedure edit utilities are described first, followed by a detailed description of the 
keywords associated with a terminal procedure and examples. 



ERMINAL PROCEDURE EDIT UTILITIES 



CTP - CREATE TERMINAL PROCEDURE 
QCTP - QUIT CREATE TERMINAL PROCEDURE 
MTP - MODIFY TERMINAL PROCEDURE 
QMTP - QUIT MODIFY TERMINAL PROCEDURE 
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CAUTION 

It is critical that all syntax errors be removed from a terminal procedure 
data base prior to its being used by the Poller, since unpredictable 
results will occur if syntax errors are present. Therefore, the DX1 Text 
Editor should not be used since it does not verify the syntax of the ter- 
minal procedure data base. 



4.4.1 Create Terminal Procedure (CTP) 

The CTP utility is used to create a terminal procedure data base. This utility does not prompt the 
operator; rather, the input is free-form similar to the DX10 Text Editor, and uses the same function 
keys and text edit commands. The only difference is in the terminate command, QCTP. 

4.4.2 Quit Create Terminal Procedure (QCTP) 

The QCTP command prompts the operator with ABORT. With the operator response of YES, the 
input is discarded. If the response is NO, the task displays the following prompts: 



QUIT CREATE TERMINAL PROCEDURE 

OUTPUT FILE ACCESS NAME: 

REPLACE?: NO 
LOG ERRORS TO: 



The utility will place the input text in the file specified, validate the syntax of the terminal pro- 
cedure data, and log errors to the device/pathname specified. 
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4.4.3 Modify Terminal Procedure (MTP) 

This command is used to modify a terminal procedure data base. MTP prompts for a file 
pathname, checks that the file exists, and that the file is not in use. The MTP supplies, as default, 
the entire contents of the file specified. The MTP uses the same function keys as the DX10 Text 
Editor and has an associated terminate command, QMTP. 

4.4.4 Quit Modify Terminal Procedure (QMTP) 

The QMTP is similar to the QCTP command, in that it prompts the operator with ABORT. If the 
response is NO, the following prompts are displayed: 



QUIT MODIFY TERMINAL PROCEDURE 

OUTPUT FILE ACCESS NAME: 

REPLACE?: NO 
LOG ERRORS TO: 



QMTP places the modified terminal procedure data in the specified file, validates the syntax of the 
entire file and logs errors to the device/pathname specified. 
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4.4.5 Terminal Procedure Keywords 

A terminal procedure is composed of Poller keywords and specific terminal commands which 
designate the action which is to take place between the Poller and the remote terminal. The 
following keywords are associated with entries in a terminal procedure data base: 

BEGIN RECEIVE 

END INVOKE 

IFERR WAIT 

SEND CTRL3780 

4.4.5.1 BEGIN. The BEGIN keyword is a reserved word which specifies the beginning of a pro- 
cedure within the terminal procedure data base. The format for beginning a procedure is as 
follows: 

Procedure name = BEGIN 

4.4.5.2 END. The END keyword is a reserved word used to terminate a procedure within the ter- 
minal procedure data base. The END phrase must be the last statement of a procedure. 

4.4.5.3 IFERR. The IFERR keyword allows the procedure to recover from certain terminal error 
conditions during the polling session. If no IFERR is specified and an error occurs, the line will be 
disconnected by the Poller and the terminal will have a status of TERM.— POLL (terminated by 
Poller). The Poller will continue to run. The format for the IFERR allows for zero or more four-digit 
error codes (separated by commas) and a qualifier, which can be either ABORT, CONTinue, 
Disconnect, EXIT, or RETRY. 

The format of an IFERR statement is as follows: 

IFERR <XXXX,XXXX> ABORT 

CONT 
DISC 
EXIT 
RETRY 

ABORT qualifier will cause the terminal session to be abruptly terminated and the terminal status 
to be changed to TERM.— POLL (terminated by Poller). 

CONTinue tells the Poller to ignore the particular error (if specified), or any error (if no error code is 
specified) and to attempt to continue the terminal session. 

Disconnect causes the terminal session to be terminated, but the terminal status will show 
SUCC.CPLT. (successful completion). 

EXIT allows the user to exit the current procedure and begin executing the next procedure 
specified in the activity template. If no next procedure exists, the session will be disconnected as 
a successful session. 

The RETRY qualifier causes the entire procedure to be reattempted; if after three retries the pro- 
cedure is still in error, the terminal session is aborted, but the Poller will continue to run. 
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An example of IFERR keywords is as follows: 

IFERR 4077 EXIT 
IFERR 4024,4045 ABORT 
IFERR CONT 

The preceding IFERR example would cause the Poller to: 

• Exit the procedure if error 4077 occurs 

• Abort the terminal session if error 4024 or 4045 occurs 

• Continue the session otherwise 

When using successive IFERR commands, the user should be careful to ensure that the order of 
the IFERR commands indeed realizes the logic desired. Additionally, an IFERR statement may 
check for a successful status, 0000. 

4.4.5.4 SEND. The SEND keyword causes the Poller to issue a command to the presentation ser- 
vice routine to begin the transfer of a DX10 data file to a precreated file in the remote terminal. 
Note that DX10 synonyms are not supported within the DX10 file pathnames associated with a 
SEND command. Optional parameters allow the network administrator to specify the terminal file 
name to receive the data and the length of the records to be sent (TTY only). If the DX10 file name 
ends with the string ???, it will cause the Poller to append the terminal number to the file name. If 
the file name ends with ??, it will cause the line number to be appended, (for example xx from 
CMxx). If more than one terminal is sharing the same terminal procedure, the ??? or ?? feature can 
be used to generate a unique file name for each terminal or line, respectively. The resulting file 
name must not exceed eight characters in length. 

CAUTION 

In systems using both CMxx and STxx lines for polling, do not use the 
?? format for file names if the same number CM and ST lines are to be 
used (for example: CM04 and ST04) because the Poller will try to 
access the same file for both lines. 

The format and examples of a SEND command for TTY and 3780 are as follows: 

(A) TTY FORMAT: SEND DX10-FILENAME <TO BMT-FILE> <LL = 80> <APPEND> <LRC> 

<A> 

If <TO BMT-FILE> is not specified, it will default to the currently-defined RECORD file. If line 
length (LL) is not specified, it defaults to the maximum value, 80. If APPEND (or A) is not 
specified, the BMT-FILE will be rewound; otherwise, the contents of the DX10 file will be 
appended to the current contents of the BMT-FILE. If LRC is specified, then an LRC and 
sequence number are generated and sent in place of the last two characters of each record. 
(Refer to the BMTS-990 User's Guide for details on the file transfer to the 763/765 BMT.) 
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EXAMPLES 

SEND P0LLERTEST.FILE1 — send to RECORD file on 763/765 

— LL = 80 (or file record length) 

— no LRC or seq.no. 

SEND POLLER.TEST.FILE TO BMTEST LL = 36 LRC 

SEND POLLER.TEST.SND??? — ??? REPLACED BY TERM.NO. 

(B) 3780 FORMAT: SEND DX10-FILENAME <TO BMT-FILE> <DX10-3780-PARAMETERS> 

If <TO BMT-FILE> is not specified, the file will be sent to the 3780 terminal's currently 
specified punch file. If <TO BMT-FILE> is specified, the Poller will change the 3780 
terminal's punch file to the given file name. The only legal parameters for <DX10-3780- 
PARAMETERS> are TY, CE, and VFC, which can be set to ON or OFF. Refer to the CTRL3780 
keyword for additional details and additional capabilities. 
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EXAMPLES 

(1) SEND POLLER.T.F?? 

GENERATES: 

SS*PU*POLLER.T.F?? — send to punch (default) 

— replace ?? with line number 
WAITS* 

(2) SEND POLLER.TEST.FILE1 TO BMTFIL TY = OFF 

GENERATES: 

TY*OFF* — Be sure TY is off 

S*<$$$$CHA 3780 PUN = BMTFIL>* — Set up punch file 

SS*PU*POLLER.TEST.FILE1* — Send to punch file 

WAITS* 

(3) CHA 3780 PRINTER = BMTFIL [767 PARAMETERS] 
SEND POLLER.T.S123 TO PRINTER 

GENERATES: 

S*<$$$$CHA 3780 PRI = BMTFIL [767 PARAMETERS]>* 

SS*PR*POLLER.T.S123* — send to printer file 

WAITS* 



[767 PARAMETERS] are 3780 tuning parameters for the punch or printer devices; reference 
the 767/769 BMT Systems Manual for details. 

Punch Printer Description 

PUM = ON (OR OFF) PRM = ON (OR OFF) Mapping 

PUV = ON (OR OFF) PRV = ON (OR OFF) Vertical forms control 

PUE = ON (OR OFF) PRE = ON (OR OFF) Compression/Expansion 

Defaults for PUNCH and PRINTER are: 

MAPPING and COMPRESSION/EXPANSION ON 
VERTICAL FORMS CONTROL OFF 



CAUTION 

The terminal procedure (TP) command SEND DX10-FILE TO BMTFIL 
automatically generates a CHANGE 3780 PUN = BMTFIL command to 
the 767 terminal. Therefore, the user should not do his own CHANGE 
3780 PUN = BMTFIL command when using this format, or redundant 
queuing in the 767 punch queue will result. 
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4.4.5.5 RECEIVE. The RECEIVE keyword causes the Poller to issue a command to the presenta- 
tion service task to begin the transfer of a terminal file and to place the received data in the 
specified DX10 file. DX10 synonyms are not supported within the receive file pathname. If the 
DX10 file name ends with the string ???, it will cause the the Poller to append the terminal number 
to the file name. If the file name ends with ??, it will cause the line number to be appended (xx 
from CMxx). If more than one terminal is sharing the same terminal procedure, the ??? or ?? 
feature can be used to generate a unique file name for each terminal or line, respectively. 



CAUTION 

In systems using both CMxx and STxx lines for polling, do not use the 
?? format for filenames if the same number CM and ST lines are to be 
used (for example: CM04 and ST04) because the Poller will try to 
access the same file for both lines. 



The format and examples of receive commands are as follows: 

(A) TTY FORMAT: RECEIVE DX10-FILENAME <FROM BMT-FILE> <BLOCKED> <LRC> 

<B> 

<CONT> 
<C> 

If <FROM BMT-FILE> is not specified, the file transfer will be assumed to come from the cur- 
rently specified playback file. If BLOCKED (or B) is specified, then the file will be transferred 
one block at a time. If CONT (or C, or nothing) is specified, the file will be transferred con- 
tinuously, which is the default. If LRC is specified, then LRC and sequence number checking 
is performed on the file records as they are received; otherwise, no checking is performed. 
(Refer to the DX10 Bubble Memory Terminal Support BMTS-990 User's Guide for details.) 



EXAMPLES 

( 1 ) RECEIVE POLLER.TEST.RECFIL1 — Receive from PLAYBACK 

— Default = CONTinuous 

— No LRC or SEQ.NO. checking 

( 2 ) RECEIVE POLLER.TEST.RFILE001 FROM BMTEST BLOCKED LRC 
( 3 ) RECEIVE POLLER.TEST.RF??? — ??? replaced by terminal number. 

(B) 3780 FORMAT: RECEIVE DX10-FILENAME <FROM BMT-FILEX767 PARAMETERS> 

When polling a 767/769 BMT and the <FROM BMT-FILE> is specified, the Poller will 
automatically perform a CHA 3780 REA = <BMT-FILE> sequence to initiate the file transfer. If 
any <767 PARAMETERS> are given, they are appended onto the end of the CHA command. 
When polling a 767/769 BMT and no <FROM BMT-FILE> is specified, the DX10-FILENAME is 
placed on the DX10 3780 print queue; the next command is expected to be a CHA 3780 
REA = <BMT-FILE>. See example 3 below for the dual command format. 
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When polling a 990 as the 3780 terminal, a DX10 pathname must be specified as the <BMT- 
FILE>; if none is supplied, a Poller error (4E00) is returned during the polling and the receive 
is not performed. 



EXAMPLES 

(1) RECEIVE VOL1.TEST.RFIL1 FROM BMTFIL TRA = ON 

GENERATES: 

RPR*STATUS-FILE* 

RPR*VOL1.TEST.RFIL1* 

S*<$$$$CHA 3780 REA = BMTFIL TRA = ON>* 

WAIT*RPR* 

(2) RECEIVE POLLTEST.RFIL1 

GENERATES: 

RPR*STATUS-FILE* 

RPR*DX10-FILE* 

(3) RECEIVE #DX10-FILENAME (Binary file) 
CHANGE READER = BMTFIL [767 PARAMETERS] 

GENERATES: 

RPR*STATUS-FILE* 

RPR*DX10-FILENAME* 

S*<$$$$CHANGE 3780 READER = BMTFIL [767 PARAMETERS]>' 

WAIT'RPR* 



The status file is used internally by the Poller to receive completion codes from the BMT. 

[767 PARAMETERS] are the 3780 tuning parameters for the reader device; refer to the 767/9 
Systems Manual for details. 

Reader Description 

TRA = ON (OR OFF) Transparency mode 

MAP = ON (OR OFF) ASCII-to-EBCDIC mapping 

COM = ON (OR OFF) Space compression 

EOF= EMB (EMC,EMR,EBC) End-of-file action 

Defaults are transparency and compression OFF, mapping ON, and EOF set for EMB (end 
message and bid). 
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CAUTION 

The resulting CHANGE 3780 READER = X plus the 767 parameters plus 
the four $ signs must be less than 48 bytes which is the limitation of the 
DX10 3780 Emulator for a single command. Using the most- 
compressed format, three 767 parameters should be able to be set. If 
the 48 byte limit is exceeded, the Poller error >4300 will be generated. 



When receiving files from a remote 990 terminal, the current status of the 3780 port on the host 990 
terminal (TY, CE, RPRRL) will affect how the file is received, since these status settings are used 
to form the command which causes the remote 990 terminal to send the file. For example, the ter- 
minal procedure data base commands: 

CTRL3780TY = ON 

CTRL3780CE = OFF 

CTRL3780 RPRRL = 80 

RECEIVE .FILEY FROM DSC2.FILEX 

will generate the following 3780 Emulator commands: 

RPR\FILEY* 
S*<$$$SSS*T*0*80*PR*DSC2.FILEX*>* 

Finally, when using 3780 protocol, if the Poller attempts to receive a nonexistent or empty file 
from the remote terminal, the receive will fail with an idle error. Refer to the DX10 3780 Emulator 
User's Guide for details. 

4.4.5.6 INVOKE. The INVOKE keyword, allows the operator to have the Poller execute a user- 
developed task during a terminal session. The user task is bid by the presentation service task. 
The session does not continue until the invoked task has completed, unless the optional 
CONTinue parameter is specified. This capability is intended to provide for minor processing dur- 
ing the terminal session. The Poller passes Poller-specific and user-defined data to the task 
through parameters (see description below). The invoked task can access this information 
through the S$PARMS subroutine call. See language manuals for high-level language interface 
with S$PARMS. 

Only one task per line may be invoked at a time; if a second invoke is attempted while the previous 
task is still running, a Poller error (5500) will be issued and the second task will not be started. 

If the DX10 task name ends with the string ???, it will cause the Poller to append the terminal 
number to the task name. If the task name ends with ??, it will cause the line number to be ap- 
pended (xx from CMxx). 
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CAUTION 

In systems using both CMxx and STxx lines for polling, be careful when 
using the ?? format with task names if the same number CM and ST 
lines are to be used (for example: CM04 and ST04) because the Poller 
will bid the same task for both lines. 



The format and examples of INVOKE commands are as follows: 

FORMAT: INVOKE LANGUAGE TASKNAME LUNO = >XX <PARMS = (XX,XX,XX,XX)><CONTINUE> 

<CONT> 



LANGUAGES supported are ASSEMBLY, COBOL, FORTRAN, PASCAL 

TASKNAME is the user's task name. 

LUNO is the global LUNO assigned to the user's program file which contains the 
TASKNAME. 

A maximum of 4 parameters may be passed to the user-task via the PARMS=( , , , ) expres- 
sion. These PARMS may be constants, flags, etc.; each parameter may be up to 8 characters 
Icng and any or all may be NULL. The data that may be retrieved by the user task includes ad- 
ditional data; the parameters in the INVOKE command are retrieved as system parameters 11 
through 14. For example: 

PARM 1 - PARM 8 — COBOL (ONLY) 

PARM 9 — TERMINAL ID (XXX) 

PARM 10 — STATION ID (XX) 

PARM 11 — PARM 14 — USER PARAMETERS 1-4 (OPTIONAL) 

PARM 15 - RETRY COUNT (X) 

If CONTINUE (or CONT) is specified, the user task will be bid and the terminal session will 
continue to the next command in the terminal session. If CONTINUE (or CONT) is not 
specified, the user task will be bid and the terminal session will not continue until the user 
task has terminated. The latter is the recommended use of INVOKE. In either case, the user 
task can set the synonym $$CC to a completion code, which can be tested in the terminal 
procedure by an IFERR immediately after the INVOKE in the latter case, and following a WAIT 
in the former case. The $$CC synonym must be set as five bytes with the format OXXXX, 
where XXXX is the completion status. 

EXAMPLES 

(1) INVOKE ASSEMBLY COMPAR1 LUNO = >44— Poller waits until task is done 

(2) INVOKE COBOL COMPAR2 LUNO = >44 CONT — Concurrent task 
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4.4.5.7 WAIT. The WAIT keyword will force the Poller to wait for the invoked task (invoke and 
continue) to complete. If the user task sets $$CC with a completion status, the user can test the 
completion status with an IFERR statement immediately after the WAIT command. The $$CC 
must be set as five bytes with the format OXXXX, where XXXX is the completion status. 

4.4.5.8 CTRL3780. During a polling session with a 3780-type terminal, it is often useful to be 
able to modify certain DX10 3780 Emulator dynamic parameters. The CTRL3780 keyword allows 
the following DX3780 parameters to be set from within a terminal procedure data base. (Refer to 
the DX10 3780 Emulators User's Guide for further description.) 

TY = ON/OFF 

CE = ON/OFF 

VFC = ON/OFF 

TRAILB = ON/OFF 

SRL = XX (MAX = 255) 

RPRRL = XX (MAX = 255) 

The format of these commands in the terminal procedure data base is as follows: 

CTRL3780 <PARAMETER> 

Only one command is allowed per line. If the command is improper for any reason (format, syntax, 
etc.), a Poller error (5400) is returned. Care must be taken when using the send record length (SRL) 
command to send files with short record lengths, since the length set also affects the length of 
the commands sent. 

Once any of the above dynamic parameters is changed, the change remains in effect until the 
dynamic parameter is explicitly changed again. 

In the following terminal procedure data base example, a TIBOL program file (DS01. DEMO. PGM) is 
sent to a 767 file (PGM1). (Note the use of CTRL3780 commands.) 

SENDHLTH = BEGIN 

CTRL3780SRL = 80 
DELETE FILE =PGM1 
IFERR CONT 
CREATE FILE=PGM1 SIZE = 90 LENGTH = 72 
CHANGE 3780 PUNCH = PGM1 PUV = OFF 
CTRL3780TY = ON 
CTRL3780SRL = 72 
SEND DS01.DEMO.PGM 
CTRL3780SRL = 80 
END 
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4.4.6 Terminal Procedure Data Base Example 

The following examples are procedures for a 763/765 Bubble Memory Terminal. (Refer to the 
Model 763/765 Memory Terminals, Operating Instructions). The terminal specific commands used 
within the terminal procedures are 763/5 Bubble Memory Terminal commands. 



PROC1 = BEGIN 

FREE DATAFL 
DELETE DATAFL 
CREATE DATAFL L 20 72 

IFERR 4024 CONT 
CHANGE RECORD TO DATAFL 
SEND VOL1.SEND.DATA 
LOCK DATAFL 
END 

PROC2A = BEGIN 

FREE MSGALL 

IFERR 4034 CONT 
DELETE MSGALL 

IFERR 4034 CONT 
CF MSGALL L 20 72 
IFERR 4014,4021,4054 ABORT 
CG REC TO MSGALL 
SEND VOL1.SEND.MSG??? 
LOCK MSGALL 
END 

PROC46 = BEGIN 

CG PLAYBACK TO DATALL 

RECEIVE VOL1.RECEIVE.RCV??? 

INVOKE ASSEMBLY TASKA LUNO = >A0 

CG REC TO RESULT 

SEND VOL1.SEND.RESLT??? 

END 



Begin procedure. 
This procedure sets 

up the terminal to 

receive the first 

message file and sets 

the record to that file. 
Send DX10 file. 
Lock data file. 
End of procedure. 

Begin procedure. 

Unlock file. 

Continue on error 4034. 

Delete the file. 

Continue on error 4034. 

Create file. 

Abort on these errors. 

Change record file. 

Send terminal messages. 

Lock file. 

End of procedure. 

Begin procedure. 

DATALL for transmission 
to a DX10 file, 
bid task TASKA, 
and sends invoke task 
results to terminal. 

End of procedure. 
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4.5 ACTIVITY TEMPLATE EDIT COMMANDS (/AT) 

An activity template file contains a generic description of the activity that is to occur when polling 
a terminal. Each terminal must have a corresponding activity template file; however, activity 
templates may be shared by several terminals. The activity template associated with each terminal 
is specified in the terminal's entry in the terminal data base. 

An activity template specifies the names of the logical procedures that are to be performed with 
the terminal; the exact definition of these procedures is resolved in a terminal procedure file. The 
terminal procedure data base to be used in resolving the logical procedures is specified in the first 
command of the activity template. 

Operator input of the /AT command displays the menu of activity template commands which 
follows. The various commands are explained first, followed by a detailed description of the ac- 
tivity template keywords and an example of an activity template. 



ACTIVITY TEMPLATE COMMANDS 



CAT - CREATE ACTIVITY TEMPLATE 
QCAT - QUIT CREATE ACTIVITY TEMPLATE 
MAT - MODIFY ACTIVITY TEMPLATE 
QMAT - QUIT MODIFY ACTIVITY TEMPLATE 



[] 
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CAUTION 

It is critical that all syntax errors be removed from an activity template 
data base prior to being used by the Poller. Therefore, the DX10 Text 
Editor should not be used since it will not verify the syntax of the activi- 
ty template data base. 



4.5.1 Create Activity Template (CAT) 

The CAT utility allows the operator to create an activity template. This utility does not prompt the 
operator since the input is free-form similar to the DX10 Text Editor. This command uses the same 
editor function keys and has a terminate command named QCAT. 

4.5.2 Quit Create Activity Template (QCAT) 

This command prompts for the keyword ABORT. If the reply is YES, the input is discarded. If NO, 
the utility displays the following: 



QUIT CREATE ACTIVITY TEMPLATE 

OUTPUT FILE ACCESS NAME: 

REPLACE?: NO 
LOG ERRORS TO: 




The input is saved in the specified pathname and the syntax of the AT statements is verified; any 
errors are logged to the device/pathname specified. 
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4.5.3 Modify Activity Template (MAT) 

The MAT command allows the operator to modify an existing activity template. The utility verifies 
the file's existence and that it is not being used by the Poller. The MAT utility supplies, as default, 
the entire contents of the file specified. The MAT command is similar to the DX10 Text Editor, 
uses the same function keys, and has a terminate command named QMAT. 

4.5.4 Quit Modify Activity Template (QMAT) 

The QMAT command is similar to the QCAT command. It prompts for the keyword ABORT. If the 
response is YES, the modifications are discarded. If the response to ABORT is NO, the following 
prompts are displayed: 



QUIT MODIFY ACTIVITY TEMPLATE 

OUTPUT FILE ACCESS NAME: 

REPLACE?: NO 
LOG ERRORS TO: 



QMAT places the modified activity template data in the specified file validates the syntax of the 
entire file, and logs any errors to the device/pathname specified. 
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4.5.5 Activity Template Keywords 

There are three types of commands that are allowed within an activity template: USE, DO, and 
DISC. Comments may be included in the AT file by preceding the text of the comment with an 
asterisk. Lines with only comments are allowed. Blank lines may also be used within the AT file; 
however, the first line may not be blank (see USE). 

The following is a description of the keywords used within an activity template file: 

4.5.5.1 USE. The USE keyword specifies the DX10 pathname of the terminal procedure data 
base to be used to resolve the procedure names in the activity template data base. Note that DX10 
synonyms are NOT supported within the DX10 pathname specified with a USE statement. The USE 
keyword must be the first entry in the activity template. However, multiple USE statements may 
appear in an activity template data base, if desired. The format of the USE statement is as follows: 

USE DX10-filename 

4.5.5.2 DO. The DO keyword causes the Poller to search the currently defined terminal pro- 
cedure data base for the named procedure and, if found, to perform whatever is contained therein. 
If the procedure is not found, an error is generated. A procedure name may be 1 to 8 characters in 
length, with the first character being alphabetic. The format of a DO statement is as follows: 

DO Procedure-name 

4.5.5.3 DISC. The DISC keyword signifies the end of the activity session, which terminates the 
polling session and disconnects the terminal. The format for a DISC statement is: 

DISC 

4.5.6 Activity Template Example 

A complete activity template is shown in the following example: 

USE VOL1.DATABASE.TP * use specified procedure data base 

DO PROC1 * perform procedure PROC1 

DO PROC2A * perform procedure PROC2A 

DO PROC46 * perform procedure PROC46 

DISC * disconnect terminal 
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4.6 POLLER DATA BASE EDIT COMMANDS (/PD) 

The Poller data base edit commands allow the operator to create and modify a Poller data base 
file. The information contained in the Poller data base includes whether the Poller is running at- 
tended or unattended; which devices and/or disk files to use to record the log information; and the 
resources available to the Poller (number of lines, protocol, mode, and modem supported by each 
line). The pathname of a Poller data base file is required when starting up the Poller via the SPO or 
TEST command. 

Operator input of the /PD command will display the following menu of Poller data base 
commands: 



POLLER DATABASE EDIT COMMANDS 

CPD - CREATE POLLER DATABASE 
MPD - MODIFY POLLER DATABASE 



CD 
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4.6.1 Create Poller Data Base (CPD) 

This command assists the operator in creating a Poller data base file. The prompting consists of a 
series of screens, as described below: 




CREATE POLLER DATABASE 

OPERATION: UNATTENDED 




The first screen prompts only for the type of environment in which the Poller will be operating. The 
response for this prompt is either UNATTENDED, the default, or ATTENDED. 

In unattended mode, the Poller will try to resolve all error conditions, based on the contents of the 
activity template and terminal procedure data bases (IFERR processing, etc.); if the error condition 
cannot be resolved, the Poller will abort the terminal session and go on to the next terminal. The 
normal mode of operation is unattended. 

In attended mode, the Poller assumes that an operator will be available as the final point of resolu- 
tion on error conditions. Therefore, if the error condition cannot be resolved, the Poller will log the 
error to the operator, change the line on which the error occurred to manual mode, and wait for the 
operator to complete the terminal session (using /PMANL commands). Multiline operation in this 
mode could be very confusing to the operator. 
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After the operator has entered a response to OPERATION, a new display is generated which 
prompts for the log file/device information. The display is formatted as follows: 



CREATE POLLER DATABASE 

LOG EVENT: 
TO: 



The response to LOG EVENT is the type of log information to be logged; the response to TO is the 
DX10 device or file pathname to which the information is to be logged. Up to ten (10) files/devices 
may be assigned to log the various types or combinations of log information; DX10 synonyms may 
not be used in the log file/device descriptions. Entry of log event data is terminated upon a 
response of RETURN (only) to the LOG EVENT prompt, or when ten log files/devices have been 
entered. 



The allowed responses to LOG EVENT are: 



Response 

ALL 

ABORTS 

ERRORS 

NORMALS 

STATISTICS 

UNINITIABLES 



Log Contents 



All Poller commands, errors, and messages 

Aborted terminal sessions 

Any Poller errors 

All successfully completed sessions 

Terminal and line statistics 

Terminals which could not be reached 

(phone busy, bad ABM, etc.) 
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The same log information may be logged to multiple devices/files. The log files generated are un- 
formatted; the utilities LLF and SLF should be used to generate a formatted listing or display. 

Any device used for logging must be constantly available to the Poller since the log data is not 
spooled to the device. If the log device is a terminal (STxx) or a line printer (LPxx), then all control 
characters (those less than hexadecimal 20) are converted to spaces before being logged. 

After the log information has been entered, a new series of displays is generated to input the 
physical resources to be used by the Poller. The prompts are as follows: 



CREATE POLLER DATABASE 

LINE: 

MODE: 

MACS NUMBER: 

WATS BAND: 

PROTOCOL : 

MODEM TYPE: 




4-46 



2302679-9701 



Network Administrator Instructions 4.6.1 



The response to LINE is a STxx line (for TPD devices) or CMxx line (for 3780-type devices) to be 
used by the Poller. These lines must previously have been defined to the DX10 operating system 
with the proper defaults for these device types; refer to paragraph 5.2 for details. 

The response to MODE may be either CALL, ANSWER or MANUAL. This parameter tells the Poller 
how to initially use the line during the polling session. The operator may change this line mode 
during execution of the Poller via the Poller Line (/PLINE) utilities. 

A response to MACS NUMBER is only required if a Vadic MACS chassis is being used in support 
of this particular line. If so, then the required input is two characters; the first is the MACS chassis 
number; the second is the position of the modem within the chassis. These two characters (fol- 
lowed by an " = " sign) will be sent prior to the telephone number whenever dialing is done on this 
line. 

The WATS BAND response is a single character value, as follows: 

Value Meaning 

blank Direct distance dialing (DDD) or local line. 

Intrastate WATS line. 

1-6 Interstate WATS bands. 

The response to PROTOCOL may be TTY765 (or TTY) or 3780. No checking is performed to make 
sure that the protocol is appropriate for the line. Note that there is no distinction made between 
TTY765 and TTY. 

Finally, the modem type is a description of the modem associated with the line. The response is 
from zero to four characters in length. 



NOTE 

The responses to MODE, WATS BAND, PROTOCOL, and MODEM 
TYPE for the line must match the corresponding characteristics in 
the terminal data base for each terminal that may be polled using 
the line. 
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When a I the line prompts have been answered, the operator is prompted whether there is more 
line information to be entered, as follows: 



CREATE POLLER DATABASE 

MORE: YES 
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If YES is entered in response to MORE, then the Poller will prompt the operator for the information 
for an additional line. If the NO response is entered, the input session is assumed to be complete 
and the operator is prompted for the DX10 file pathname where the Poller data base file should be 
stored: 



CREATE POLLER DATABASE 

POLLER DATABASE PATHNAME: 

REPLACE: NO 
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4.6.2 Modify Poller Data Base (MPD) 

The MPD command allows the operator to modify the contents of a Poller data base file. The MPD 
utility prompts for the pathname of the data base file to be modified, as follows: 




MODIFY POLLER DATABASE 

POLLER DATABASE PATHNAME: 
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Once the pathname has been entered, the operator is prompted for the portion of the Poller data 
base to be modified: 



MODIFY POLLER DATABASE 
OPERAT I ON/LOG/RESOURCE : 
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If the operator enters either OPERATION or O, a screen is generated which contains the previously 
entered response for the OPERATION keyword. When the operator accepts the previous response 
or enters a new response, the utility prompts whether more modifications are to be made, as 
follows: 



MODIFY POLLER DATABASE 

MORE: YES 
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A response of NO causes the utility to exit; a YES response returns the display to the 
OPERATION/LOG/RESOURCE prompt. 

If the operator's response to OPERATION/LOG/RESOURCE is LOG or L, then the utility scrolls 
through the previously entered log file/device assignments. The operator may accept the previous 
values by pressing the RETURN key or may change any value by entering the new data. When the 
last of the log file assignments has been displayed, the next display will show the prompts only; 
the operator may then assign additional log file/devices. A response of just the RETURN key ter- 
minates the log modifications and brings up the MORE prompt. 

If the operator enters RESOURCE or R in response to the OPERATION/LOG/RESOURCE prompt, a 
new screen will be generated requesting whether a line is to be added, changed, or deleted: 



MODIFY POLLER DATABASE RESOURCES 
ADD/CHANGE/DELETE RESOURCE: 
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If the CHANGE function is selected, the operator is prompted to enter the LINE for which the data 
is to be changed: 



MODIFY POLLER DATABASE RESOURCE 
LINE: 



When the appropriate line name (STxx or CMxx) is entered, the utility checks that an entry for that 
line is already in the Poller database, and if so, displays the previously entered values for that line. 
After the operator has performed the modifications, if any, to the line entry, the screen is returned 
to the MORE display. 

If the ADD function is selected, then the operator is prompted for an entire line entry, as in Create 
Poller data base (CPD). After the entry has been entered, the display is returned to the MORE 
prompt. 

If the DELETE function is selected, the operator is prompted to enter the LINE to be deleted. The 
utility checks that the entry for that line exists and then deletes the entry. The display returns to 
the prompt for MORE. 
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AJ DELETE DATA STRUCTURE (DDS) 

The DDS utility allows the operator to delete a Poller data structure. The DDS utility is analogous 
to the DX10 Delete File (DF) procedure; it is provided to allow the network administrator to tailor 
the delete function to the particular Poller requirements. The DDS utility then displays the 
prompts DATA STRUCTURE PATHNAME and ARE YOU SURE. The prompts are formatted as 
follows: 




DELETE DATA STRUCTURE 

DATA STRUCTURE PATHNAME: 

ARE YOU SURE: NO 



The utility makes certain that the file exists and is not in use. If the reply to ARE YOU SURE is YES, 
the specified data base file will be deleted. 
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4.8 PRINT DATA STRUCTURE (PDS) 

The PDS utility allows the operator to print a Poller data structure. The PDS utility is analogous to 
the DX10 Print File (PF) procedure; it is provided to allow the network administrator to tailor the 
print function to the particular Poller requirements. When the PDS utility is invoked, it prompts for 
a pathname, printing device, and the number of copies to be printed. The prompts are formatted as 
follows: 



PRINT DATA STRUCTURE 

DATA STRUCTURE PATHNAME: 
PRINT DEVICE: 
NUMBER OF COPIES: 1 



The file is then queued up for printing on the designated device. 



2302679-9701 



4-57 



4.9 Network Administrator Instructions 



4.9 SHOW DATA STRUCTURE (SDS) 

The SDS utility allows the operator to display the contents of a Poller data structure on the Model 
91 1 VDT. The SDS utility is analogous to the DX10 Show File (SF) procedure; it is provided to allow 
the network administrator to tailor the show function to the particular Poller requirements. The 
operator input of SDS displays the prompt for the data structure pathname as shown below. 




SHOW DATA STRUCTURE 

DATA STRUCTURE PATHNAME: 
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5.1 POLLER NETWORK 

This section assists the network administrator or systems analyst in successfully implementing 
the polling network. This section presents information on system memory and data disk space 
requirements, user throughput constraints, and communication hardware requirements. The 
section also presents worksheets to aid in making these determinations and examples of their 
use. The network administrator must be capable of analyzing this data and determining the sys- 
tem configuration required, considering applications, operations, and appropriate tradeoffs in 
configuring the system. 

5.1.1 Poller Network Planning 

The network administrator must consider many factors when planning a polling network in order 
to properly utilize the physical communications hardware, system and disk storage, and DX10 sys- 
tem resources. It is not required that the system be configured and used only for the Poller; how- 
ever, all guidelines provided in this section address Poller requirements only. 

5.1.2 Terminal Network Planning 

A major factor in Poller network planning is the number and type of terminals to be polled during a 
given polling session. This information, in addition to the allowable polling time, determines the 
number of physical lines that the Poller must support and the hardware that is needed to support 
the lines. 

If the number of communication boards required to support these lines exceeds the space avail- 
able in the main system chassis, then an additional (expansion) chassis is required. If the number 
of lines required exceeds the limits imposed by either the DX10 operating system or the Poller, 
then you must either relax the time constraint for the polling activity, or utilize additional polling 
systems. 

The following is a worksheet used to estimate the number of TPD or 3780 lines required in a par- 
ticular Poller configuration: 

(1) NUMBER OF TERMINALS TO BE POLLED 



(2) AVERAGE (OR MAXIMUM) DATA TO BE TRANSFERRED TO AND RECEIVED 
FROM EACH TERMINAL DURING THE POLLING SESSION (BYTES) 

(3) TOTAL DATA VOLUME TO BE MOVED (LINE 1 X LINE 2) (BYTES) 

(4) LINE TRANSFER RATE (CPS: CPS = BPS / 10) 

(5) TOTAL SECONDS REQUIRED (LINE 3 / LINE 4) 
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(6) ALLOWABLE POLLING TIME (IN HOURS) 

(7) POLLING TIME (IN SECONDS) (LINE 6 X 3600) 

(8) NUMBER OF LINES REQUIRED (LINE 5 / LINE 7) 



You should perform this calculation for both TPD and 3780 lines. The result is the total number of 
lines required in the Poller system. The total number of lines cannot exceed eight; DX10 system 
generation (SYSGEN) constraints may further limit the total, depending upon the number and type 
of other devices and the additional DX10 features the user's system includes. 

5.1.3 Disk Storage Planning 

Another factor you must consider when planning the Poller network is the amount of disk storage 
required to store all the data that is to be transmitted to and/or received from each terminal. 

During the initial phase of disk storage planning, it is more important to calculate the maximum 
gross storage requirements for the network data files than the disk overhead requirements to sup- 
port a directory structure. You can use the following worksheet to estimate the disk storage 
requirements: 

(1) TOTAL NUMBER OF TERMINALS IN SYSTEM 



(2) MAXIMUM AMOUNT OF DATA TO BE STORED ON DISK FOR EACH 
TERMINAL (FILES TO BE SENT AND RECEIVED) (BYTES) 

(3) DATA VOLUME TO SUPPORT TERMINALS FOR ONE DAY (LINE 1 X LINE 2) 

(4) NUMBER OF DAYS (OF DATA) THAT USER WISHES TO RETAIN ON DISK 
(MINIMUM 1: CURRENT DAY) 

(5) TOTAL TERMINAL DATA TO BE RETAINED ON DISK (LINE 3 X LINE 4) 

(6) TOTAL STORAGE REQUIREMENTS FOR NONTERMINAL SPECIFIC DATA 
(SUCH AS TIBOL PROGRAM FILES OR DEFAULT DATA FILE) 

(7) TOTAL STORAGE REQUIREMENTS (LINE 5 + LINE 6) 



NOTE 

You should increase the total storage requirement by some per- 
centage (such as 10 to 20 percent) to include miscellaneous files 
and directory overhead. You should then compare the resulting total 
to the available disk space other than on the system disk. 
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5.1.4 Magnetic Tape Planning 

If you plan to utilize the optional Model 979A Magnetic Tape Drive in the system, you should 
review the characteristics of the device, as well as the operational aspects of the Poller tasks 
(WDTM, RMTD, RFLT, and WTLT) and any user-supplied task(s) that support the writing of data to 
the magnetic tape. You should also consider the format, blocking, and volume of the data that is 
written to the tape to ensure proper utilization in the application. 

5.1.5 DX10 Usage Planning 

The worksheets provided to estimate Poller system timing assume that only the Poller application 
software and supporting communication packages run in the system during the polling session. If 
the user has additional tasks executing in the system, then the estimates may not be meaningful 
since the load on the DX10 operating system resources cannot be accurately estimated. Any 
major activity degrades the operation of the Poller and decreases the data throughput. 

5.1.6 DS990 Memory Planning 

When you determine the required number of lines, you should estimate the system memory 
requirements to support simultaneous sessions on these multiple lines. The following worksheet 
assists in this estimation. (The provided task sizes in the worksheet are in bytes, not words.) 

(1) SYSTEM SIZE (FROM SYSGEN) 



(2) POLL MASTER TASK SIZE 28K Bytes 

(3) NUMBER OF 3780 LINES: 

(4) SIZE OF PS3780 AND EM3780 TASKS (per line): 23KBytes 

(5) TOTAL FOR 3780 LINE SUPPORT (LINE 3 X LINE 4) 

(6) NUMBER OF TPD LINES: 

(7) PSTTY765 TASK SIZE: 16KBytes 

(8) TOTAL FOR TPD LINE SUPPORT (LINE 6 X LINE 7) 



(9) SIZE OF ERROR LOGGING TASK _ 3K _ 

(10) SIZE OF LARGEST OPERATOR INTERFACE TASKS (POPCP) _ 8K _ 

(11) SCI TASK PER VDT + INVOKE/LINE + OTHER SYSTEM TASKS (TOTAL 

MEMORY REQUIRED) 



(12) SIZE OF OTHER TASKS THAT WILL BE EXECUTING SIMULTANEOUSLY 
TO POLLER OPERATION (TOTAL) 

(13) TOTAL MEMORY REQUIREMENTS 

(LINE 1+2 + 5 + 8 + 9+10 + 11 + 12) Total Bytes 
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NOTE 

For maximum data throughput, all Poller tasks should be in memory 
while the Poller is executing. If you do not provide enough memory 
to support all the tasks that should be operating simultaneously, 
then the Poller throughput is adversely affected. 



5.2 DX10SYSGEN CONSIDERATIONS 

Before the user can integrate and use the Poller the DX10 SYSGEN must include certain Poller, 
BMTS-990 and/or EM3780 considerations. 

You must determine the physical configuration of the hardware prior to beginning the SYSGEN 
process. Each line supporting teleprinter devices (TPDs) in the system requires two half-slots of 
chassis space. Each 3780 line in the system requires two or three half slots: two half slots if an 
external ACU and modem are used; three half-slots if internal ACU and modem are used. 

For example purposes, assume that the Poller supports one TPD line and one 3780 line and that 
the communications hardware to support these lines is as follows: 

• TPD Hardware (with External Modem and ACU): 

— Communications interface (l/F) card, slot 10 (right) 

— External ACU l/F card, slot 10 (left) 

• 3780 Device Hardware (with Internal Modem and ACU): 

— Communications l/F card, slot 12 (right) 

— Internal 201 modem card, slot 13 (right) 

— Internal ACU l/F card, slot 13 (left) 
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Graphically, the chassis might appear as follows: 



SLOT(S) 

i - 6 

7 

8 

9 
10 

1 1 

12 
13 



LEFT 


RIGHT 


SYSTEM CONTROLLER AND MEMORY BOARDS 


SYSTEM DISK CONTROLLER 


UNUSED 


91 1 VDT DUAL CONTROLLER 


EXT. ACU I/F (TPD) 


COMM. I/F (TPD) 


UNUSED 


LPOI 


COMM. I/F (3780) 


INT. ACU (3780) 


INT 201 MODEM (3780) 



2280987 



5.2.1 TPD Definition 

To ensure that the Poller supports Models 763/765 Bubble Memory Terminals (BMTs), the user 
must define the BMT line to the system during the SYSGEN process as a TPD. The following 
display shows the SYSGEN inputs required to define the TPD line discussed in the example in 
paragraph 5.2: 



DEVICE: TPD 

CRU: OOO) >0C0 < 

ACCESS TYPE: (RECORD) 

TIME OUT: (0) 30 < 

TERMINAL TYPE: (743) 763 < 

ECHO: (YES) NO 
MODEM DUPLEX: (FULL) 
SWITCHED: (NO) YES 

I NTERFACE : ( COMM ) < 

SPEED: (300) 1200 <-— 

ACU CRU: (NONE) >0E0 <:--• 
CHARACTER QUEUE SIZE: (6) 200 <--■ 

INTERRUPT: (6) 11 <--• 



THIS EXAMPLE 

USER SPECIFIABLE 

763 OR 765 HANDLED THE 



SAME 



THIS EXAMPLE 

THIS EXAMPLE 

THIS EXAMPLE 

AT LEAST 1 FULL BMT RECORD 

THIS EXAMPLE 



If the Poller is to use multiple lines, you must define each line supporting TPDs through the 
SYSGEN process as in the preceding example. For further explanation see DX10 SYSGEN pro- 
cedures in the DX10 Operating System Systems Programming Guide, Volume V and in the DX10 
Bubble Memory Terminal Support (BMTS-990) User's Guide. 
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5.2.2 3780 Device Definition 

The following display shows the required SYSGEN inputs to define the 3780 line discussed in the 
example in paragraph 5.2: 



DEVICE 

CRU OR TILINE ADDRESS 

NUMBER OF CHANNELS 

CHANNEL PROTOCOL 

BUFFER SIZE 

INTERRUPT 



COM 

>0040 

1 

3780 

528 

4 



(Example) 



if the Poller is to use multiple lines, you must describe each port supporting 3780 devices via the 
SYSGEN process as in the preceding example. 

The following display shows the recommended DX10 Build Emulator Task (BET) parameters for 
the 3780 task to support the Poller: 



PRINTER ACCESS NAME 

PUNCH ACCESS NAME 

NUMBER OF USER FLAGS 

PENDING REC/SEND REQUESTS 

TY ON? 



DISCONNECT ON ERROR?: NO 
DISCONNECT REMOTE: YES 



CALL CONNECT TIMEOUT (MIN) 

CALL RETRY COUNT 

CALL RETRY TIME (MIN) 

INTERDIGIT TIMEOUT (100MS) 

DIAL TONE TIMEOUT (100MS) 

PND TIMEOUT (100MS) 



LP*i 


(Default) 


DUMY 


(Default) 


16 


(Default) 


8 


(Default) 


NO 


(Default) 


NO 


(Default) 


YES 







(Default) 







3 


(Default) 


10 


(Default) 


10 


(Default) 





(Default) 
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RPN ON?: 

RPN CODE: 

VFC ON?: 

SRQ ON?: 

SRQ CODE: 

TRAILING BLANKS? 

TBID ON? 

TASK BID CODE 

*OPR ON? 

*OPR CODE 

*-OPTION CHARACTER 



YES 

NO 

YES 

-***S' 

YES- 
NO 

'*BID' 
NO 
'*OPR-' 



(Default) 
(Default) 

(Default) 



(Default) 
(Default) 
(Default) 
(Default) 
(Default) 



MAX TRANSMIT RECORD LENGTH: 256 

MAX RECEIVE RECORD LENGTH: 256 

SRL DEFAULT: 30 

RPURL DEFAULT: 80 

RPRRL DEFAULT: SO 



(Default) 
(Default) 
(Default) 
(Default) 



The following display shows the recommended DX10 Build Communications DSR (BCD) para- 
meters for 3780 lines which will support the Poller: 



BID RESPONSE 


TIMEOUT (SEC): 


03 




RECEIVE ACK 


TIMEOUT (SEC): 


05 




RECEIVE DATA 


TIMEOUT (SEC): 


00 


(Default) 


IDLE LINE 


TIMEOUT (SEC): 


60 






TRANSMIT BID: 


1 






RECEIVE ENQ: 


15 


(Default) 




TRANSMIT ENQ: 


15 


(Default) 




RECEIVE NAK: 


00 


(Default) 




TRANSMIT NAK: 


00 


(Default) 




RECEIVE DATA: 


00 





NOTE 



For the Poller to operate properly, you should apply the optional 
3780 patch, which allows the IDLE ERROR message to be generated 
without disconnecting the session. 



For SYSGEN details refer to the DX10 3780/2780 Emulator Object Installation Manual as well as 
the DX10 Operating System Systems Programming Guide, Volume V. 



2302679-9701 



5-7 



5.2.3 Network Implementation 



5.2.3 Additional SYSGEN Considerations 

You must consider these additional parameters during the SYSGEN process: system table area, 
maximum number of foreground and background tasks, additional input/output (I/O) buffer area, 
and intertask communication area. The proper allocation for these parameters is critical to the 
operation of the Poller. 

You can calculate the system table size by using the worksheet provided in Appendix J of the 
DX10 Operating System Systems Programming Guide, Volume V. The guidelines stated there 
describe the minimum table size allocation. 

When the Poller is executing, it has three foreground tasks for the main tasks and one additional 
foreground task for each line (two for 3780 lines) that it uses. If you want the Poller to invoke tasks, 
they should be included. You should add the total of all Poller tasks to the other tasks (such as 
reports and displays) you select, to arrive at the proper limit for foreground and background tasks 
in the system. 

For each 3780 line that the system supports simultaneously, a 2128-byte buffer is required in the 
additional I/O buffer area. You should provide an intertask buffer area of approximately 2K-bytes to 
support the Poller intertask communications. 

If an insufficient amount of intertask communication area (ITC) is requested when the system is 
generated, or if the needs of a combination of tasks requiring ITC exceeds that area, the Poller 
may beccme unoperational. The operator should first attempt to execute an Abort Poller Oper- 
ation (APO) command. The APO command aborts the Poller tasks and purges the ITC queues used 
by the Poller. However, the APO command requires a small amount of ITC area, and fails when that 
area is not available. 

If the APO command fails, you must execute a Kill Task (KT) command to abort the Poller task. 
You must know the run ID and the station number of the task, which is task PMT, installed ID >01. 
The Poller occurrence number is the run ID of task PMT. To obtain the station number, execute a 
Show Task Status (STS) command and note the terminal to which the task with installed ID >01 
and run ID equal to the occurrence number is assigned. This is the station number to use in the KT 
command. Execute the command using the run ID and this station number. 

The KT command aborts the Poll Master Task PMT, causing it to execute its end action routine. 
This routine terminates all the Poller tasks that are executing and purges the ITC queues being 
used by the Poller. 
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5.3 POLLER NETWORK IMPLEMENTATION 

The network administrator must provide the data structures required for the terminal network and 
its applications. Before starting the first Poller occurrence, the network administrator must per- 
form the following steps: 

1. Install Poller software and patches. 

2. Unless the defaults used in the delivered software apply, execute the Poller Initial- 
ization (PIN) command to change one or more of the following parameters: 

a. Maximum number of lines to be used by the Poller 

b. Number of passes through the polling list 

c. Number of seconds to wait between passes 

d. Matching specification for WATS lines 

e. Enabling of the automatic shutdown feature 

f. Restart point for interrupted terminal sessions 

g. Capability of multiple dial-ins 

3. Execute the PATCH command as described in the object installation guide. 

4. Execute the Create Terminal List (CTL) command to create terminal lists, which identify 
terminals. 

5. Execute the Create Terminal Data Base (CTD) command to create terminal data bases, 
which define the terminals. 

6. Execute the Create Activity Template (CAT) command to create an activity template for 
each required terminal activity. 

7. Execute the Create Terminal Procedure (CTP) command to create terminal procedure 
data bases that contain the procedures called by the activity templates. 

8. Execute the Create Poller Data Base (CPD) command to create Poller data bases to 
specify logs and to define lines. 
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5.4 POLLER SOFTWARE INSTALLATION 

Procedures for the installation and checkout of the Poller are described in detail in the DX10 Poller 
Application Software Object Installation Guide. The installation of the BMTS-990 package and/or 
the DX10 3780 Emulator are described in their own respective installation guides. 



NOTE 

Do not install the Poller in directory .POLLER on the system disk. 
Directory .POLLER is reserved for use by the Poller. 

5.5 POLLER INITIALIZATION (PIN) 

As delivered, the Poller supports up to four lines. If the system needs to accommodate more than 
four lines, the number of lines may be increased to the user's configuration, up to a maximum of 
eight lines. 

To accomplish this customization, execute the PIN command. You must perform the steps listed 
in Section 2 to access the Poller first, and you must have a privilege level of 6 or higher to execute 
this command. When the Poller main menu is displayed, enter the command as follows: 

[]PIN 
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Poller displays the following prompts: 



VERIFY PIN PARAMETERS 

MAX NUMBER OF LINES 

TRIES OF POLLING LIST 

WAIT TIME BETWEEN TRIES 

WATS MATCHING (EXACT/LE) 

AUTOMATIC SHUTDOWN AT END 

RESTART AT PROC LEVEL 

ALLOW MULTIPLE DIAL-INS 





EXACT 
YES 
YES- 
NO 







The response to MAX NUMBER OF LINES prompt is the number of lines to be supported by the 
Poller software on the user's system. The range of values is from 1 to 8; the default is 4. You need 
not change this value unless more than four lines are required. 

The response to the TRIES OF POLLING LIST prompt is the maximum number of times the Poller 
attempts to complete a session with each terminal on the terminal list. The Poller does not retry a 
session unless the session was prematurely terminated or was not successfully connected. The 
range of this response is from 1 to 5; the default is 2. 

The response to the WAIT TIME BETWEEN TRIES prompt is the minimum time (in seconds) to wait 
before making the next pass through the terminal list. The response is a number from to 999; the 
default is 0. The capability of waiting between passes is used in Europe; U. S. users should enter 
the default. A wait between passes causes some degradation of the Poller throughput. 



2302679-9701 



5-11 



5.5 Network Implementation 



The response to the WATS MATCHING (EXACT/LE) prompt controls the matching of terminals to 
lines. The WATS band of a line indicates the area limit for calls on the line. WATS band consists 
of your state. Higher-numbered bands include successively larger areas. When you enter EXACT 
in response to this prompt, the Poller calls each terminal on a line having the same band number 
as the terminal. When you enter LE (for less than or equal), the Poller uses any line having a band 
number that allows calls to the terminal (that is, a band number less than or equal to that of the ter- 
minal). European users who do not have WATS service should use the default setting (EXACT) and 
set the WATS band of lines (in the Poller data base) and terminals (in the terminal data base) to the 
same band number. 

A YES response to the AUTOMATIC SHUTDOWN AT END prompt causes the Poller to issue a Ter- 
minate Poller Operation (TPO) command after attempting to conduct sessions with all terminals. 
When you enter a NO response, you must manually terminate Poller operations. The Poller does 
not automatically terminate unless all lines are in the CALL mode (none in MANUAL or ANSWER 
mode). All of the following conditions must be met for automatic shutdown to occur: 

• All the terminals have had successful sessions, or have been retried the maximum 
number of times. 

• No line has any more activity waiting. 

The response to RESTART AT PROC LEVEL prompt specifies the point at which to restart an inter- 
rupted session. When you enter YES, the Poller restarts the terminal session at the beginning of 
the procedure that was interrupted when the session was terminated. When you enter NO, the 
Poller restarts at the first procedure specified in the activity template for the terminal. 

The response to the ALLOW MULTIPLE DIAL-INS prompt determines the number of calls allowed 
for terminals in the ANSWER mode during an occurrence. A YES response allows multiple dial- 
ins; a NO response (the default) allows only one successful session per terminal. You must be cer- 
tain that a successive call in to the Poller does not overwrite previously received data or data to be 
transmitted if you allow multiple dial-ins. 

The PIN process is a series of procedures (PROCS) and batch streams which prompts the user for 
specific configuration information and then assembles, links, and reinstalls the Poller Main Task 
(PMT) in the Poller program file. The entire process takes about 15 minutes on a DS990 Model 4 
system. 

Following successful completion of the PIN command, execute the PATCH command again as 
described in the object installation guide. 
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5.6 POLLER NETWORK EXAMPLE 

The following paragraphs provide an example of the steps required to establish a polling network. 
First, assume the following polling network description: 

400 Model 763 BMTs 

• 20K bytes to be transmitted (total of send/receive) 

• 1200 bits per second transmission speed (120 bytes/sec) 

• 8 hours allowable polling time 

5.6.1 Example Polling Line Calculation 

With the preceding assumptions, you can determine the number of required lines to support this 
activity in the specified time period. (The line numbers reference the worksheet in paragraph 
5.1.2.) 

(1) NUMBER OF TERMINALS: _ 400 _ 

(2) AVERAGE DATA (bytes) PER TERMINAL: _20,000_ 

(3) TOTAL DATA VOLUME (bytes): 8,000,000 

(4) TRANSFER RATE (CPS): _ 120 _ 

(5) TOTAL SECONDS REQUIRED (sec): 66,667 

(6) ALLOWABLE POLLING TIME (HRS): 8 



(7) CONVERSION (1HR= 3600 sec): 8X3600 = 28,800 

(8) NUMBER OF LINES REQUIRED: _2.32_ 

The user should provide at least three lines. These lines will accomplish the polling task easily 
within the eight-hour period, even allowing for system overhead (such as dial/redial time, com- 
mand transmission, error checking, and retries). 
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5.6.2 Example Disk Storage Calculation 

For purposes of disk storage planning, assume the following configuration: 

• 400 terminals to be polled each day 

• 20,000 bytes sent/received per terminal per day 

• All data must be retained on disk as received from the terminal for one day after received 
(two days total) for backup purposes. 

Utilizing these assumptions, you can determine the disk requirements for this polling network: 

(1) NUMBER OF TERMINALS: _ 400 _ 

(2) AVERAGE DATA (BYTES): _20,000_ 

(3) TOTAL DATA VOLUME (BYTES): 8,000,000 

(4) NUMBER OF DAYS TO STORE: 2 

(5) DISK STORAGE FOR TERMINAL DATA: 16,000,000 

(6) ADDITIONAL STORAGE REQUIREMENTS: 2,000,000 

(7) TOTAL STORAGE REQUIREMENTS: 18,000,000 

You should provide a minimum of 20,000,000 bytes of nonsystem disk storage to support this 
polling network. 
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The following list contains the Poller commands, an expansion of their meanings, and the para- 
graph reference where the command is treated. 



Command 


Description 


Paragraph 


PQ 


Return to DX10 SCI Menu 


2.3 


/POPER 


Poller Operation Utilities 


3.1 


/PCTRL 


Poller System Control Commands 


3.2 


SPO 


Start Poller Operation 


3.2.1 


HPO 


Halt Poller Operation 


3.2.2 


RPO 


Restart Poller Operation 


3.2.3 


TPO 


Terminate Poller Operation 


3.2.4 


APO 


Abort Poller Operation 


3.2.5 


TEST 


Test Poller Operation 


3.2.6 


/PLINE 


Poller Line Commands 


3.3 


SLO 


Start Line Operation 


3.3.1 


TLO 


Terminate Line Operation 


3.3.2 


ALO 


Abort Line Operation 


3.3.3 


/PMANL 


Poller Manual Commands 


3.4 


/MTTY 


Manual TTY Commands 


3.4 


/M3780 


Manual 3780 Commands 


3.4 


MANSR 


Manual Answer 


3.4.1 


MBAUD 


Manual Modify Baud Rate 


3.4.2 


MCALL 


Manual Call 


3.4.3 


MDISC 


Manual Disconnect 


3.4.4 


SCMDTTY 


Manual Send BMT Command TTY 


3.4.5 


SFNCTTY 


Manual Send BMT Function TTY 


3.4.6 


SFILTTY 


Manual Send File TTY 


3.4.7 


RBLKTTY 


Manual Receive File Blocked TTY 


3.4.8 


RCONTTY 


Manual Receive File Continuous TTY 


3.4.9 


SCMD3780 


Manual Send BMT Command 3780 


3.4.10 


SFIL3780 


Manual Send File to 3780 Terminal 


3.4.11 


RFIL3780 


Manual Receive File from 3780 Terminal 


3.4.12 


CTRL3780 


Manual Change 3780 Emulator Dynamic Parameter 


3.4.13 
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Command 

/PMEDM 

WDTM 

RMTD 

WTLT 

RFLT 

CTH 

/PSTAT 

RPS 
RLS 
RTS 
SPA 
SLF 
LLF 

/PCONFG 

/TL 

CTL 
MTL 



/TD 



/TP 



/AT 



CTD 
MTD 



CTP 
QCTP 
MTP 
QMTP 



CAT 
QCAT 
MAT 
QMAT 



/PD 



Description 

Poller Medium Commands 

Write from Disk to Magnetic Tape 
Read from Magnetic Tape to Disk 
Write to IBM Standard Labeled Tape 
Read from IBM Standard Labeled Tape 
Create IBM Standard Label Tape Header 

Poller Status Commands 

Request Poller Status 
Request Line Status 
Request Terminal Status 
Show Poller Activity 
Show Log File 
List Log File 

Poller Configuration Utilities 

Terminal List Edit Utilities 

Create Terminal List 
Modify Terminal List 

Terminal Data Base Edit Utilities 

Create Terminal Data Base 
Modify Terminal Data Base 

Terminal Procedure Edit Commands 

Create Terminal Procedure 
Quit Create Terminal Procedure 
Modify Terminal Procedure 
Quit Modify Terminal Procedure 

Activity Template Edit Commands 

Create Activity Template 
Quit Create Activity Template 
Modify Activity Template 
Quit Modify Activity Template 

Poller Data Base Edit Commands 



Paragraph 

3.5 

3.5.1 
3.5.2 
3.5.3 
3.5.4 
3.5.5 

3.6 

3.6.1 
3.6.2 
3.6.3 
3.6.4 
3.6.5 
3.6.6 

4.1 

4.2 

4.2.1 
4.2.2 

4.3 

4.3.1 
4.3.2 

4.4 

4.4.1 
4.4.2 
4.4.3 
4.4.4 

4.5 

4.5.1 
4.5.2 
4.5.3 
4.5.4 

4.6 
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Command 

CPD 
MPD 



DDS 
PDS 
SDS 
PIN 



Description 

Create Poller Data Base 
Modify Poller Data Base 

Delete Data Structure 

Print Data Structure 

Show Data Structure 

Verify PIN Parameters 



Paragraph 

4.6.1 
4.6.2 

4.7 

4.8 

4.9 

5.5 
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Appendix B 

Poller Status Messages 
and Error Recovery 



This appendix contains the general format of Poller messages followed by the specific messages 
and their explanation. 

POLLER MESSAGES 
The general format of all Poller messages is as follows: 

PPXX YYYY: Poller message 
where: 

PP is the Poller status/error code listed below. 

XX is the DX10 supervisor call error code (may be blank). 

YYYY may be the line on which the error occurs (STXX or CMXX). 

may be the communication subsystem (BMTS OR 3780) error code (manual com- 
mands only), 
may be blank. 

Specific messages and message explanations are listed below: 

Code Message Action/Explanation 

0000 POLLER SPO<TEST> COMPLETE SPO/TEST start-up completion mes- 
OCCURRENCE NUMBER IS: >XX sage; >XX is the run-time ID of the 

Poller task. 

01XX POLLER TOCCUR ERROR Poller failed when accessing the file 

.POLLER.TOCCUR. Check the DX10 
SVC error (00XX). 

02XX POLLER S$ROUTINE ERROR Poller error when accessing the TCA 

file; try command again. 

03XX POLLER OCCURRENCE STATE Illegal sequence of commands, use 

INVALID RPS to verify Poller state. 

04XX POLLER PREVIOUS OPERATOR Operator request out of sequence 

REQUEST PENDING (e.g., HPO after TPO). Poller waiting 

for previous request to complete. 
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Code 

05XX 

06FA 
0700 



OAXX 

OBXX 
0C01 



Message 

POLLER INTERTASK 
COMMUNICATION FAILED 

POLLER OCCURRENCE 
ALREADY EXISTS 

POLLER START FAILED; UNABLE 
TO ACTIVATE LINE 



POLLER LINE NOT IN MANUAL 
MODE 

POLLER LINE NUMBER INVALID 

POLLER BID PS TASK ERROR 



ODXX POLLER MAX LINES EXCEEDS 
SDA 



OEXX POLLER MANUAL LINE STATE 
INVALID 



OFXX POLLER TERMINAL LIST DOES 
NOT CONTAIN TERMINAL 
NUMBER 

10XX POLLER WORKING DATA 
STRUCTURE FILE ERROR 



11XX POLLER DATABASE FILE ERROR 



Action/Explanation 

Intertask buffer area not large 
enough; generate system again. 

Previous occurrence is still running; 
use RPS to verify. 

SPO fatal error, be sure that there is 
no other activity on the line that 
failed. Can be a line in the PDB that is 
not in the system. Check the ALL or 
ERRORS log file for the cause of the 
error. Also, for 3780, Global LUNO 
>82 may not be assigned to the 3780 
program file .SSCOMMPF or the 
wrong release of DX3780 is being 
used (must be 4.0 or later). 

Manual command issued to line 
that is not in manual mode. 

Line number not in PDB. 

SPO fatal error — PS task could not 
be bid; line is not in the system (see 
DX10 error >2B01) or an STOx line is 
not provided for use by CMOx. 



Number of lines 
than number of 
Poller initiation. 



in PDB is greater 
lines provided at 



Manual command out of sequence; 
for example, manual send attempted 
before MCALL issued. 

Answer-mode error; number of 
terminal that called Poller is not in 
terminal list. 

Working data structure file error. 
WDS is an internal Poller file in the 
.POLLER directory; check SVC error 
(00XX). 

Poller data base file error; check 
DX10 SVC error (00XX). 
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Code Message 

12XX POLLER TERMINAL DATABASE 
FILE ERROR 

13XX POLLER TERMINAL LIST FILE 
ERROR 

14XX POLLER SHARED DATA AREA 
FILE ERROR 



15XX POLLER TOCCUR FILE ERROR 



16XX POLLER UNKNOWN MANUAL 
COMMAND 

1700 POLLER MANUAL CALL 
SUCCESSFUL 

1800 POLLER MANUAL ANSWER 
SUCCESSFUL 

1900 POLLER MANUAL MODIFY 

BAUD UNSUCCESSFUL 

1A00 POLLER ANSWER; ATTEMPT TO 
CALL IN FAILED 



1 BOO POLLER MANUAL CALL 
UNSUCCESSFUL 

1C00 POLLER MANUAL MODIFY 
BAUD SUCCESSFUL 



Action/Explanation 

Terminal data base file error; check 
DX10 SVC error (00XX). 

Terminal list file error; check DX10 
SVC check DX10 SVC error (00XX). 

Shared data area file error; SDA is an 
internal Poller file in the .POLLER 
directory; check DX10 SVC error 
(00XX). 

Table of occurrence file error; check 
DX10 SVC error (00XX). 

Operator entered invalid command; 
submit an STR. 

Satisfactorily completed. 



Satisfactorily completed. 



Check MBAUD inputs. 



Answer failed; modems may be 
incompatible, or the ABM was wrong 
(manual answer only). 

Incorrect phone number, wrong ABM, 
line busy, etc. 

Satisfactorily completed. 



1D00 POLLER MANUAL DISCONNECT 
UNSUCCESSFUL 

1 E00 POLLER MANUAL RECEIVE 
SUCCESSFUL 

1F00 POLLER MANUAL RECEIVE 
UNSUCCESSFUL 

2000 POLLER TLO FAILED; PMT 
REQUEST PENDING 



Poller was unable to disconnect 
manual line. 

Satisfactorily completed. 



Receive failed; consult the communi- 
cation subsystem error code. 

HPO, TPO, APO, or TLO, ALO 
pending 
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Code Message 

2100 POLLER SLO FAILED; PMT 

REQUEST PENDING 

2200 POLLER ALO ERROR; PMT 

REQUEST PENDING 

2300 POLLER ALO COMPLETE 

2400 POLLER UNABLE TO DIS- 

CONNECT LINE 



2500 POLLER SESSION ERROR; LINE 
SWITCHED TO MANUAL 

2600 POLLER TLO COMPLETE 

2700 POLLER UNKNOWN COMMAND 
COMPLETION FROM PS 

2800 POLLER SLO COMPLETE 

2900 POLLER SLO ERROR; UNABLE 
TO ACTIVATE LINE 

2A00 POLLER RPO COMPLETE 

2B00 POLLER RPO POWER FAILURE 
COMPLETE 

2C00 POLLER UNABLE TO KILL 

OUTSTANDING CALL/ANSWER 

2DXX POLLER RPO POWER FAILURE 
COULD NOT COMPLETE 

2E00 POLLER MANUAL SEND 
SUCCESSFUL 

2F00 POLLER MANUAL SEND 

UNSUCCESSFUL 

30XX POLLER ACTIVITIES ARE 
TERMINATED 

3100 POLLER TPO COMPLETE 

3200 POLLER APO COMPLETE 



Action/Explanation 



See 2000 



See 2000 



Satisfactorily completed. 

Poller was unable to disconnect line; 
another disconnect is automatically 
sent by the Poller. 

Attended mode (only); operator must 
continue the session manually. 

Satisfactorily completed. 

Problem in PS or in intertask com- 
mand area; submit STR. 

Satisfactorily completed. 

SLO command failed, see description 
for 0700. 

Satisfactorily completed. 

Satisfactorily completed. 



Line could not be disconnected 



RPO after power failure failed; check 
log file, fix problem, and retry. 

Satisfactorily completed. 



Send command failed; see com- 
munication subsystem error. 

SPO failed; check DX10 SVC error 
(00XX). 

Satisfactorily completed. 

Satisfactorily completed. 
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Code Message 

33XX POLLER RPO ERROR: UNABLE 
TO ACTIVATE LINE 

34XX POLLER RPO POWER FAILURE 
ERROR; UNABLE TO ACTIVATE 
LINE 

3500 POLLER HPO COMPLETE 

3600 POLLER HPO ERROR; 

OPERATOR REQUEST PENDING 

3700 POLLER MANUAL DISCONNECT 
COMPLETE 

3800 POLLER DISCONNECT FAILED; 
LINE ALREADY DISCONNECTED 

3900 POLLER TERMINAL NUMBER 

HAS NO CORRESPONDING TDB 
ENTRY 

3AXX POLLER UNABLE TO START 
"ERRLOG" 



3B00 POLLER MANUAL ACTIVITY 
SESSION COMPLETED 
SUCCESSFULLY 

3C00 POLLER MANUAL ACTIVITY 
SESSION COMPLETED 
UNSUCCESSFULLY 



Action/Explanation 

RPO failed; check log file, fix 
problem, retry RPO. 

RPOPF after power failure failed; 
check log file, fix problem, retry RPO. 



Satisfactorily completed. 
TPO, APO, or HPO pending. 

Satisfactorily completed. 

Satisfactorily completed. 



Add terminal entry to TDB (terminal 
data base). 



SPO failed; may have done SPO too 
soon after TPO or APO of previous 
Poller. 

Satisfactorily completed. 



Activity session had an error; check 
the log file. 



3D00 POLLER TERMINAL NOT IN 
"CALL" OR "EITHER" MODE 

3E00 POLLER TERMINAL NOT IN 

"ANSWER" OR "EITHER" MODE 

3F00 POLLER ANSWER; SESSION 

ALREADY SUCCESSFUL OR IN 
PROGRESS 



4000 POLLER ANSWER; TERMINAL 

NUMBER NOT IN TERMINAL LIST 



Manual call attempted to a terminal in 
answer mode. 

Manual answer attempted to a 
terminal in call mode. 

Terminal called which already had 
session, or multiple terminals have 
same terminal number. PIN can be 
done to allow multiple dial-ins. 

Terminal called Poller but was not in 
the terminal list being used. 
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Code Message 

4100 POLLER LINE NO LONGER 

USEABLE 



Action/Explanation 

Line taken out of service by Poller 
after multiple disconnects (three) 
failed. 



42 
4300 

4307 
4400 



POLLER OPERATION INVALID; 
NO POLLER CURRENTLY ACTIVE 

POLLER BMT 3780 COMMAND 
LENGTH EXCEEDED 48 
CHARACTERS 



POLLER HAS NO LINES 
SPECIFIED IN POLLER 
DATABASE FILE 



No SPO has been done. 



Length of 3780 BMT command 
exceeds 48 characters. 



See 5700 

SPO failed, no line entries in PDB file. 



4500 POLLER ILLEGAL COMMAND 

FOR THIS TERMINAL TYPE 



46 POLLER HPO REQUEST 
INITIATED 

47 POLLER RPO REQUEST 
INITIATED 

48 POLLER TPO REQUEST 
INITIATED 

49 POLLER APO REQUEST 
INITIATED 

4A POLLER ALO REQUEST 

INITIATED 



An illegal command for the type of 
terminal being polled was found in 
the terminal procedure data base. 

HPO began satisfactorily. 



RPO began satisfactorily. 



TPO began satisfactorily. 



APO began satisfactorily. 



ALO began satisfactorily. 



4B POLLER TLO REQUEST 

INITIATED 

4C POLLER SLO REQUEST 

INITIATED 

4D POLLER MANUAL REQUEST 

INITIATED 



TLO began satisfactorily. 



SLO began satisfactorily. 



Manual request began satisfactorily. 
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Code Message 

4E00 POLLER RECEIVE FROM FILE 
MUST BE SPECIFIED 

4F00 POLLER 3780 EMULATOR NOT 
ACTIVE 

50XX POLLER ASSIGNING LUNO TO 
"POLLMSGS" FILE 
UNSUCCESSFUL 



51XX POLLER OPENING "POLLMSGS" 
FILE UNSUCCESSFUL 

52XX POLLER READ ERROR ON 
"POLLMSGS" FILE 

53XX POLLER READ ERROR ON 

"POLLMSGS"; ERROR CODE 
DOES NOT EXIST 

5400 POLLER INVALID CTRL3780 

COMMAND 



5500 POLLER PREVIOUSLY INVOKED 

TASK STILL RUNNING 



5600 POLLER TERMINAL ABMS 

DON'T MATCH 



5700 POLLER GOT NO RESPONSE 

FROM 3780 EMULATOR 



Action/Explanation 

When polling a remote 990, a FROM 
file must be specified. 

The 3780 Emulator being used with a 
Poller line has been killed. 

Check that file POLLER.POLLMSGS 
exists; if not, then restore the file 
from the distribution media and 
write/delete protect file. 

See 5000 



See 5000 



Poller error not found in 
.POLLER.POLLMSGS. Submit STR. 



An invalid CTRL3780 command was 
found in the terminal procedure data 
base. 

Terminal procedure data base error; a 
second invoke command was 
attempted prior to the first task 
terminating. 

The supplied ABM for the terminal 
(TDB) did not match the received 
ABM; the session was terminated. 

Activation of 3780 failed; probably 
wrong version of DX3780 (must be 
4.0.x); see also Poller error 0700. 
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LOG FILE ERROR CODES 

To interpret the errors returned in 
Log File (LLF) and Show Log File 



Error 

ooxx 

40XX 
41 XX 

42XX 

XXXX 

4307 
4500 
4E00 
4F00 
5400 
5500 
5600 
5700 

XXXX 
000A 



Source 

763/765 
767/769 

TTY 

TTY 

TTY 

3780 

POLLER 
POLLER 
POLLER 
POLLER 
POLLER 
POLLER 
POLLER 
POLLER 

DX10 
DX10 



ihe ERROR column of the display/report generated by the List 
(SLF) tasks, consult the following reference documents: 

Reference 

763/765 Operating Instructions 
767/769 Systems Manual 

BMTS-990 User's Guide 

DX10 Error Reporting and Recovery Manual 
(Vol VI) 

BMTS-990 User's Guide 

DX3780 Emulator User's Guide 



DX10 Poller Errors 
(see above) 



DX10 Error Reporting and Recovery Manual 
(Vol VI) 

If this error occurs after an INVOKE on a 
TTY line, the BMTS-990 timed out the line 
operation and disconnected the line during 
the INVOKE. 
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C.1 MODELS 763/765 BUBBLE MEMORY TERMINALS 

The following display shows an appropriate status setting for Models 763/765 Bubble Memory Ter- 
minals using an external, 1200-baud, full-duplex modem to interface with the Poller via the Bubble 
Memory Terminal Support (BMTS-990) communications subsystem: 



>STATUS 
LINE MODE: 
OPTIONS ON: 
OPTIONS OFF: 
ABM: 

RECORD FILE: 
PLAYBACK FILE: 
TRANSMIT EOL: 
RECEIVE EOL: 
KEY: 



EIA/ 1200 BAUD/ EVEN PARITY/ FULL DUPLEX/ 
PCHECK/ AUTOABM/ EOTDIS/ EDC/ DC3/ DC1.3/ DC2.4/ 
ABMPRT/ BUFFER/ 
User specified 



cr 
cr 



NOTE 



The ABM should include the terminal number (for example, 
BMT001, where 001 is the terminal number). The baud rate and 
duplex are dependent on the modem being used. 



The following status is appropriate when communicating with a Model 765 terminal via the 
acoustic coupler: 



>ST 

LINE MODE: 
OPTIONS ON: 
OPTIONS OFF: 
ABM: 

RECORD FILE: 
PLAYBACK FILE: 
TRANSMIT EOL: 
RECEIVE EOL: 
KEY: 



INTERNAL/ 300 BAUD/ EVEN PARITY/ FULL DUPLEX/ 
PCHECK/ AUTOABM/ EOTDIS/ EDC/ DC3/ DC1.3/ DC2.4/ 
ABMPRT/ BUFFER/ 
BMT002 



cr 
cr 
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C.2 MODELS 767/769 BUBBLE MEMORY TERMINALS 

The following display shows the appropriate settings for polling a Model 767/769 Bubble Memory 
Terminal via the DX10 3780 Emulator: 



>REP3780 FILE = 


User determined 


POR: P1 


ENQ: 


20 


SPE: SYNC 


BID: 


20 


DUP: FULL 


NAK: 


20 


MOD: SLAVE 


NOR: 


POWUP 


BLO: 512 


ABN: 


POWUP 


DEL: 


ALT: 




NOA: 180 


ID: 


<terminal ID> 



NOTE 



Modems operating in full duplex include Bell 212A and Vadic 34XX. 
Modems operating in half duplex include Bell 201C compatible 
modems. File POWUP, which is specified for normal and abnormal 
disconnects, restarts the 3780 task. It might contain EXE 3780 
FILE = CM3780, for example. 



C.3 REMOTE 990 TERMINAL 

The following list identifies the 3780 Emulator parameter settings required to enable a remote 990 
terminal to communicate with the Poller: 

VFC set to OFF 
RPN set to ON 
SRQ set to ON 

The remote 990 must be executing the 3780 Emulator task with an Answer (ANS) command out- 
standing. The remote 990 terminal must detect an abnormal disconnect and reissue the ANS 
command. 

When a terminal procedure for a remote 990 terminal includes the keyword SEND, it must specify 
a destination (TO) file or the data is sent to the default punch file. 

When the Poller receives data files from a remote 990 terminal, the values of 3780 parameters 
RPRRL, TY, and CE supplied for the Poller determine how the file is received. When a terminal pro- 
cedure includes the keyword RECEIVE, it must specify the source (FROM) file or the Poller issues 
an error message (>4E00). 
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ASCII Code Chart 



Table D-1 shows the American National Standard Code for Information Interchange (ASCII) used in 
communications with remote terminals. 



Table D-1. ASCII Code 



Hexadecimal 


Decimal 




Hexadecimal 


Decimal 




Value 


Value 


Character 


Value 


Value 


Character 


00 


00 


NUL 


23 


35 


# 


01 


01 


SOH 


24 


36 


$ 


02 


02 


STX 


25 


37 


% 


03 


03 


ETX 


26 


38 


& 


04 


04 


EOT 


27 


39 


* 


05 


05 


ENQ 


28 


40 


( 


06 


06 


ACK 


29 


41 


) 


07 


07 


BEL 


2A 


42 


* 


08 


08 


BS 


2B 


43 


+ 


09 


09 


HT 


2C 


44 


, 


0A 


10 


LF 


2D 


45 


- 


0B 


11 


VT 


2E 


46 




OC 


12 


FF 


2F 


47 


/ 


0D 


13 


CR 


30 


48 





0E 


14 


SO 


31 


49 


1 


OF 


15 


SI 


32 


50 


2 


10 


16 


DLE 


33 


51 


3 


11 


17 


DC1 


34 


52 


4 


12 


18 


DC2 


35 


53 


5 


13 


19 


DC3 


36 


54 


6 


14 


20 


DC4 


37 


55 


7 


15 


21 


NAK 


38 


56 


8 


16 


22 


SYN 


39 


57 


9 


17 


23 


ETB 


3A 


58 




18 


24 


CAN 


3B 


59 


5 


19 


25 


EM 


3C 


60 


< 


1A 


26 


SUB 


3D 


61 


= 


IB 


27 


ESC 


3E 


62 


> 


1C 


28 


FS 


3F 


63 


? 


ID 


29 


GS 


40 


64 


@ 


IE 


30 


RS 


41 


65 


A 


IF 


31 


US 


42 


66 


B 


20 


32 


SP 


43 


67 


C 
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Table D-1. ASCII Code (Continued) 



Hexadecimal 


Decimal 




Hexadecimal 


Decimal 




Value 


Value 


Character 


Value 


Value 


Character 


21 


33 


I 


44 


68 


D 


22 


34 


" 


45 


69 


E 


46 


70 


F 


63 


99 


c 


47 


71 


G 


64 


100 


d 


48 


72 


H 


65 


100 


e 


49 


73 


I 


66 


101 


f 


4A 


74 


J 


67 


102 


g 


4B 


75 


K 


68 


103 


h 


4C 


76 


L 


69 


104 


i 


4D 


77 


M 


6A 


106 


J 


4E 


78 


N 


6B 


107 


k 


4F 


79 





6C 


108 


1 


50 


80 


P 


6D 


109 


m 


51 


81 


Q 


6E 


110 


n 


52 


82 


R 


6F 


111 


o 


53 


83 


S 


70 


112 


P 


54 


84 


T 


71 


113 


q 


55 


85 


U 


72 


114 


r 


56 


86 


V 


73 


115 


s 


57 


87 


W 


74 


116 


t 


58 


88 


X 


75 


117 


u 


59 


89 


Y 


76 


118 


V 


5A 


90 


Z 


77 


119 


w 


5B 


91 


[ 


78 


120 


X 


5C 


92 


\ 


79 


121 


y 


5D 


93 


] 


7A 


122 


z 


5E 


94 


A 


7B 


123 


1 


5F 


95 


— 


7C 


124 


1 


60 


96 


\ 


7D 


125 


( 


61 


97 


a 


7E 


126 


r\> 


62 


98 


b 


7F 


127 


DEL 
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ASCII/EBCDIC Conversion Chart 



Table E-1 shows the conversion from American National Standard Code for Information Inter- 
change (ASCII) to Extended Binary-Coded Decimal Interchange Code (EBCDIC). 
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Table E-1. ASCII-to-EBCDIC Conversion 



ASCII 
VALUE 


ASCII 
CHAR 


EBCDIC 
VALUE 


EBCDIC 
CHAR 


00 


NUL 


00 


NUL 


01 


SOH 


01 


SOH 


02 


STX 


02 


STX 


03 


ETX 


03 


ETX 


04 


EOT 


37 


EOT 


05 


ENQ 


2D 


ENQ 


06 


ACK 


2E 


ACK 


07 


BEL 


2F 


BEL 


08 


BS 


16 


BS 


09 


HT 


05 


HT 


OA 


LF 


25 


LF 


OB 


VT 


OB 


VT 


OC 


FF 


OC 


FF 


OD 


CR 


OD 


CR 


OE 


SO 


OE 


SO 


OF 


SI 


OF 


SI 


10 


DLE 


10 


DLE 


1 1 


DC1 


1 1 


DC1 


12 


DC2 


12 


DC2 


13 


DC3 


13 


TM 


14 


DC4 


3C 


DC4 


1 5 


NAK 


3D 


NAK 


16 


SYN 


32 


SYN 


17 


ETB 


26 


ETB 


1 8 


CAN 


18 


CAN 


19 


EM 


19 


EM 


1A 


SUB 


3F 


SUB 


1 B 


ESC 


27 


ESC 


1C 


FS 


1C 


IFS 


ID 


GS 


ID 


IGS 


1 E 


RS 


IE 


IRS 


IF 


US 


IF 


IUS 



ASCII 
VALUE 


ASCII 
CHAR 


EBCDIC 
VALUE 


EBCDIC 
CHAR 


20 


SPACE 


40 


SPACE 


21 


1 


5A 


1 


22 


» 


7F 


»J 


23 


# 


7B 


# 


24 


$ 


5B 


* 


25 


% 


6C 


% 


26 


& 


50 


& 


27 


y 


7D 


9 


28 


( 


4D 


( 


29 


) 


5D 


) 


2A 


* 


5C 


* 


2B 


+ 


4E 


+ 


2C 


i 


6B 


» 


2D 


- 


60 


- 


2E 


. 


4B 


. 


2F 


/ 


61 


/ 


30 





FO 





31 


1 


F1 


1 


32 


2 


F2 


2 


33 


3 


F3 


3 


34 


4 


F4 


4 


35 


5 


F5 


5 


36 


6 


F6 


6 


37 


7 


F7 


7 


38 


8 


F8 


8 


39 


9 


F9 


9 


3A 


\ 


7A 


• 


3B 


I 


5E 


5 


3C 


< 


4C 


< 


3D 


= 


7E 


= 


3E 


> 


6E 


> 


3F 


? 


6F 


? 
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Table E-1. ASCII-to-EBCDIC Conversion (Continued) 



ASCII 
VALUE 


ASCII 
CHAR 


EBCDIC 
VALUE 


EBCDIC, 
CHAR 


40 


@ 


7C 


@ 


41 


A 


CI 


A 


42 


B' 


C2 


B 


43 


C 


C3 


C 


44 


D 


C4 


D 


45 


E 


C5 


E 


46 


F 


C6 


F 


47 


G 


C7 


G 


48 


H 


C8 


H 


49 


I 


C9 


I 


4A 


J 


Ol 


J 


4B 


K 


D2 


K 


4C 


L 


D3 


L 


4D 


M 


D4 


M 


4E 


N 


D5 


N 


4F 


O 


D6 





50 


P 


D7 


P 


51 


Q 


D8 


Q 


52 


R 


D9 


R 


53 


S 


E2 


S 


54 


T 


E3 


T 


55 


U 


E4 


U 


56 


V 


E5 


V 


57 


W 


E6 


w 


58 


X 


E7 


X 


59 


Y 


E8 


Y 


5A 


Z 


E9 


z 


5B 


C 


4A 


$ 


5C 


\ 


EO 


\ 


5D 


] 


4F 


1 


5E 


A 


5F 


—7 


5F 


•m 


6D 


"— 



ASCII 
VALUE 


ASCII 
CHAR 


EBCDIC 
VALUE 


EBCDIC 
CHAR 


60 


N 


79 


s 


61 


a 


81 


a 


62 


b 


82 


b 


63 


c 


83 


c 


64 


d 


84 


d 


65 


e 


85 


e 


66 


f 


86 


f 


67 


g 


87 


g 


68 


h 


88 


h 


69 


i 


89 


i 


6A 


J 


91 


i 


6B 


k 


92 


k 


6C 


1 


93 


1 


6D 


m 


94 


m 


6E 


n 


95 


n 


6F 





96 


o 


70 


P 


97 


P 


71 


q 


98 


q 


72 


r 


99 


r 


73 


s 


A2 


s 


74 


t 


A3 


t 


75 


u 


A4 


u 


76 


V 


A5 


V 


77 


w 


A6 


w 


78 


X 


A7 


X 


79 


y 


A8 


y 


7A 


z 


A9 


2 


7B 


1 


CO 


i 


7C 


1 
1 


6A 


l 

l 


7D 


} 


DO 


( 


7E 




A1 


~ 


7F 


DEL 


07 


DEL 
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Appendix F 
Communications Cabling Diagrams 



This appendix includes diagrams of the various cabling configurations for terminals that com- 
municate with the Poller. Refer to Figure F-1 when installing or testing the communications hard- 
ware for a Model 763/765 Bubble Memory Terminal. Refer to Figure F-2 for similar information 
related to an external modem and ACU for a Model 767/769 Bubble Memory Terminal. Figure F-3 
shows the cabling configuration for an internal modem and ACU communicating with a Model 
767/769 Bubble Memory Terminal. 





990 


9461 1 7-1 










EXT ACUIF 
2263484-1 


COM 1/F 
946105-1 


MODEM 






2263477-1 


















ACU 




DAA* 

















PHONE LINK 



MODEM 



EXT. MODEM 
BELL 21 2A 
VADIC 3415 
BELL 103J 



EXT. ACU 
BELL 801 C 
VADIC 801 
BELL 801 C 



DAA* 
-NONE- 
DAA REQ'D 
-NONE- 



2200051-1 
TERMINAL MODEM 
BELL 212A 
VADIC 3455P 
BELL 1 03J 



TI 763/765 



DAA REQUIRED FOR U.S. ARRANGEMENT ONLY 



2280983 



Figure F-1. Cabling Diagram for Asynchronous, Full-Duplex TTY Communications 
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990 


9461 1 7-1 










EXT ACUIF 
2263484-1 


COM I/F 
94105-1 


MODEM 






2263484-1 


















Ad 




DAA* 

















EXT. MODEM EXT. ACU 
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Figure F-2. Cabling Diagram for 3780 Emulator Using External ACU and Modem 
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This glossary contains Poller terms and other terms that have a special usage in this manual. 

ABM — See Answerback Memory. 

Activity Session — All commands and file data transferred between the Poller and the remote ter- 
minal. The activities are described by the activity template and the terminal procedure data 
base(s) for that terminal. 

Activity Template — The DX10 disk file that contains the generic description of the activities (pro- 
cedures) to be performed with the remote terminal during the activity session. 

Answerback Memory — An identifying sequence of characters stored in the terminal and 
transmitted to identify the terminal. For dial-in operation with the Poller, the answerback 
memory must contain the terminal number as the last three characters. 

Line — The communications line that the Poller uses to communicate with the remote terminal. 
The line is described to the Poller as a TTY line (STxx) or a 3780 line (CMxx). 

Log Event — The type of data to be logged by the Poller to a particular log file or device. The 
specifiable types are all (everything), normal sessions, aborted sessions, uninitiable ses- 
sions, errors, and statistics. 

Log File or Device — The DX10 disk file or device to which a specific type of log event data is 
logged. The device may be a 911 VDT (STxx), a line printer (LPxx) or a magnetic tape drive 
(MTxx). 

Network Administrator — The person within the user organization who is responsible for main- 
taining the contents of the various Poller data bases. 

Operator — The person within the user organization who is responsible for the day-to-day oper- 
ations of the Poller. 

Poller Data Base — A DX10 disk file that contains the list of physical resources (lines) and log files 
or log devices that the Poller uses during the polling activity. 

Poller Occurrence Number — The run-time ID of the Poll Master Task (PMT) that DX10 assigns 
when the operator starts the Poller by entering a Start Poller Operation (SPO) or Test Poller 
Operation (TEST) command. The Poller occurrence number is a hexadecimal number that is 
retained in a synonym ($OCC$) for the user/terminal that started the Poller. Several of the 
Poller commands use this hexadecimal value as a response. 
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Polling Activity — All activity sessions that the Poller performs. 

Port — See Line. 

Procedure — An entity within the terminal procedure data base that details the exact actions to 
perform between the Poller and the remote terminal. 

Remote Terminal — A terminal that communicates with the Poller. 

Terminal Data Base — A DX10 disk file that contains the physical attributes of all terminals in the 
terminal list specified for the polling activity. 

Terminal List — A DX10 disk file that contains a list of the numbers of the terminals to poll during 
the polling activity. 

Terminal Number — A unique, three-digit number associated with a particular terminal in the 
user's network. Generally, the digits of the terminal number are also the last three characters 
of the answerback memory of the terminal. The range of terminal numbers is from 001 
to 999. 

Terminal Procedure Data Base — A DXTO disk file that contains the specific commands and DX10 
or terminal file names for the activity session. These commands are organized into pro- 
cedures that are referenced by the activity template associated with the particular terminal. 
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Introduction 



HOW TO USE INDEX 

The index, table of contents, list of illustrations, and list of tables are used in conjunction to ob- 
tain the location of the desired subject. Once the subject or topic has been located in the index, 
use the appropriate paragraph number, figure number, or table number to obtain the corre- 
sponding page number from the table of contents, list of illustrations, or list of tables. 

INDEX ENTRIES 

The following index lists key words and concepts from the subject material of the manual together 
with the area(s) in the manual that supply major coverage of the listed concept. The numbers along 
the right side of the listing reference the following manual areas: 

• Sections — Reference to Sections of the manual appear as "Sections x" with the sym- 
bol x representing any numeric quantity. 

• Appendixes — Reference to Appendixes of the manual appear as "Appendix y" with the 
symbol y representing any capital letter. 

• Paragraphs — Reference to paragraphs of the manual appear as a series of 
alphanumeric or numeric characters punctuated with decimal points. Only the first 
character of the string may be a letter; all subsequent characters are numbers. The first 
character refers to the section or appendix of the manual in which the paragraph may be 
found. 

• Tables — References to tables in the manual are represented by the capital letter T 
followed immediately by another alphanumeric character (representing the section or 
appendix of the manual containing the table). The second character is followed by a 
dash (-) and a number. 

Tx-yy 

• Figures — References to figures in the manual are represented by the capital letter F 
followed immediately by another alphanumeric character (representing the section or 
appendix of the manual containing the figure). The second character is followed by a 
dash (-) and a number. 

Fx-yy 

• Other entries in the Index — References to other entries in the index preceded by the 
word "See" followed by the referenced entry. 
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Index 



ABM 3.4.1, 3.4.3, 4.3.1, 4.3.3 

Abort Line Operation (ALO) Command . . 3.3.3 
Abort Poller Operation (APO) 

Command 3.2.5 

Abort Terminal Session 3.3.3 

ABORT TP File Keyword 4.4.5.3 

ABORTS, Event Type 4.1 .2 

Activity Template 1 .6.3, 3.4.1 , 3.4.3, 4.1 .1 

Blank Lines 4.5.5 

Comment Lines 4.5.5 

Data, Validate 4.5.2, 4.5.4 

Edit Utilities 4.5 

Example 4.5.6 

Keyword: 

DISC 4.5.5.3 

DO 4.5.5.2 

USE 4.5.5.1 

Keywords 4.5.5 

Pathname 4.3.1 , 4.3.3, 4.5.2, 4.5.4 

ACU 5.2 

Cabling for Internal Modem and FF-3 

Add Line 4.6.2 

Additional I/O Buffer 5.2.3 

ALL, Event Type 4.1.2 

Allow Multiple Dial-Ins 5.5 

Allowable Polling Time 5.1.2 

ALO Command 3.3.3 

Answerback 3.4.1 , 3.4.3, 4.3.1 , 4.3.3 

APO Command 3.2.5 

Append 3.4.7 

ASCII Code TD-1 

ASCII to EBCDIC Conversion TE-1 

Asynchronous Full-Duplex TTY, 

Cabling for FF-1 

AT 1.6.3 

Attended Operation 4.6.1 

Auto Answer Line Mode 1.2.2 

Auto Call Line Mode 1.2.1 

Autocall Unit 5.2 

Interface, External 1.8.1 

Internal 1.8.2 

Automatic Shutdown of Poller 5.5 

Bases, Data 4.1.1 

Baud Rate, Terminal 4.3.1, 4.3.3 

BEGIN TP File Keyword 4.4, 4.4.5.1 

Blank Lines; 

Activity Template 4.5.5 

Terminal Procedure 4.4 

Block Size 3.5.1 , 3.5.2 

Blocked Data Transfer 3.4.8 

BMT Command, 767/769 3.4.10 

BMT File Name 3.4.7, 3.4.8, 3.4.9 

BMTS-990 1.5.6 

Build Communications DSR 

(BCD) Parameters, DX3780 5.2.2 

Build Emulator Task (BET) 

Parameters, DX3780 5.2.2 



Cabling for: 
Asynchronous Full-Duplex TTY 



FF-1 



External Modem and ACU, TTY FF-1 

External Modem and ACU, 3780 FF-2 

Internal Modem and ACU FF-3 

Synchronous Half-Duplex 3780 

Emulator FF-2, FF-3 

763/765 Terminal FF-1 

767/769 Terminal FF-2, FF-3 

Calculation Example, Disk Storage 5.6.2 

CAT Command 4.5.1 

CE 3.4.11,3.4.13,4.4.5.8 

Change Line 4.6.2 

Characteristics: 

Remote 990 Terminal C.3 

763/765 Terminal C.1 

767/769 Terminal C.2 

Chassis Space, DS990 5.1 .2 

Check LRC/SEQ 3.4.8, 3.4.9 

Code, DX10SVC Error Appendix B 

Codes, Log File Error Appendix B 

Collection, Data 1.3.1 

COM, 767/769 3780 Parameter 3.4.12 

Command: 

Abort Line Operation (ALO) 3.3.3 

Abort Poller Operation (APO) 3.2.5 

ALO 3.3.3 

APO 3.2.5 

CAT 4.5.1 

CPD 4.6.1 

Create Activity Template (CAT) 4.5.1 

Create IBM Standard Label Tape 

Header (CTH) 3.5.5 

Create Poller Data Base (CPD) 4.6.1 

Create Terminal Data Base (CTD) 4.3.1 

Create Terminal List(CTL) 4.2.1 

Create Terminal Procedure File 

(CTP) 4.4.1 

CTD 4.3.1 

CTH 3.5.5 

CTL 4.2.1 

CTP 4.4.1 

CTRL3780 3.4.13 

DDS 4.7 

Delete Poller Data Structure (DDS) 4.7 

Halt Poller Operation (HPO) 3.2.2 

HPO 3.2.2 

Kill Task (KT) SCI 5.2.3 

List Log File(LLF) 3.6.6 

LLF 3.6.6 

MANSR 3.4.1 

Manual Answer (MANSR) 3.4.1 

Manual Call (MCALL) 3.4.3 

Manual Change 3780 Emulator 
Dynamic Parameter (CTRL3780) . .3.4.13 

Manual Disconnect (MDISC) 3.4.4 

Manual Modify Baud Rate (MBAUD) . .3.4.2 
Manual Receive File Blocked 

TTY(RBLKTTY) 3.4.8 

Manual Receive File Continuous 

TTY(RCONTTY) 3.4.9 

Manual Receive File 3780 

(RFIL3780) 3.4.12 



lndex-2 



2302679-9701 



Index 



Manual Send BMT Command 

TTY(SCMDTTY) 3.4.5 

Manual Send BMT Command 

3780(SCMD3780) 3.4.10 

Manual Send BMT Function 

TTY(SFNCTTY) 3.4.6 

Manual Send FileTTY(SFILTTY) 3.4.7 

Manual Send File 3780 (SFIL3780). . .3.4.11 

MAT 4.5.3 

MBAUD 3.4.2 

MCALL 3.4.3 

MDISC 3.4.4 

Modify Activity Template (MAT) 4.5.3 

Modify Poller Data Base (MPD) 4.6.2 

Modify Terminal Data Base (MTD) 4.3.2 

Modify Terminal List(MTL) 4.2.2 

Modify Terminal Procedure File 

(MTP) 4.4.3 

MPD 4.6.2 

MTD 4.3.2 

MTL 4.2.2 



MTP 
PDS 
PIN. 



4.4.3 
..4.8 
..5.5 



POLL 2.2 

Poller Initialization (PIN) 5.5 

PQ 2.3 



Print Poller Data Structure (PDS) 

QCAT 

QCTP 

QMAT 

QMTP 

Quit Create Activity Template 

(QCAT) 

Quit Create Terminal Procedure 

File (QCTP) 

Quit Modify Activity Template 

(QMAT) 

Quit Modify Terminal Procedure 

File (QMTP) 

RBLKTTY 

RCONTTY 

Read from IBM-Standard 

Labeled Magnetic Tape (RFLT) 
Read from Magnetic Tape to 

Disk(RMTD) 

Request Line Status (RLS) . 
Request Poller Status (RPS) 
Request Terminal Status (RTS) 



Restart Poller Operat 

RFIL3780 

RFLT. 

RLS.. 

RMTD 

RPO . 

RPS.. 

RTS 

SCMDTTY 

SCMD3780 

SDS 



ion (RPO) 



..4.8 
,4.5.2 
.4.4.2 
,4.5.4 
,4.4.4 



4.5.2 



4.4.2 



4.5.4 



4.4.4 
3.4.8 
3.4.9 



..3.5.4 

..3.5.2 

..3.6.2 

..3.6.1 

.3.6.3 

.3.2.3 

.3.4.12 

.3.5.4 

.3.6.2 

.3.5.2 

.3.2.3 

.3.6.1 

.3.6.3 

.3.4.5 

3.4.10 

...4.9 



SFILTTY 3.4.7 

SFIL3780 3.4.11 

SFNCTTY 3.4.6 

Show Log File(SLF) 3.6.5 

Show Poller Activity (SPA) 3.6.4 

Show Poller Data Structure (SDS) 4.9 

SLF 3.6.5 

SLO 3.3.1 

SPA 3.6.4 

SPO 3.2.1 

Start Line Operation (SLO) 3.3.1 

Start Poller Operation (SPO) 3.2.1 

Summary Appendix A 

Terminate Line Operation (TLO) 3.3.2 

Terminate Poller Operation (TPO) 3.2.4 

TEST 3.2.6 

Test Poller Operation (TEST) 3.2.6 

TLO 3.3.2 

TPO 3.2.4 

WDTM 3.5.1 

Write from Disk to Magnetic 

Tape (WDTM) 3.5.1 

Write to IBM-Standard 

Labeled Magnetic Tape (WTLT) 3.5.3 

WTLT 3.5.3 

Commands: 

Configuration Management 4.1.3 

Line Operation 3.3 

Manual 3.4 

Poller Data Base Edit 4.6 

SCI 2.1 

Status 3.6 

System Control 3.2 

763/765 BMT 3.4.5 

Comment Lines: 

Activity Template 4.5.5 

Terminal Procedure 4.4 

Communication Line 4.6.1 

Communications Interface Card 5.2 

Communications Subsystems 1.5.6 

Components, Hardware 1.7 

Compression/Expansion: 

CTRL3780 4.4.5.8 

DX3780 3.4.11 

767/7693780 3.4.12 

Configuration Management: 

Commands 4.1 .3 

Utilities 1.5.1,4.1 

Connection: 

Line 3.6.2 

Terminal 3.6.3, 4.3.1, 4.3.3 

Connection Type, Terminal 4.1.1 

Console, Operator's 3.1 

CONT TP File Keyword 4.4.5.3 

Continuous Data Transfer 3.4.9 

Conversion, ASCII to EBCDIC TE-1 

CPD Command 4.6.1 

Create Activity Template (CAT) 
Command 4.5.1 
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Create IBM Standard Label Tape 

Header (CTH) Command 3.5.5 

Create Poller Data Base <CPD) 

Command 4.6.1 

Create Terminal Data Base (CTD) 

Command 4.3.1 

Create Terminal List (CTL) Command . . . 4.2.1 
Create Terminal Procedure File (CTP) 

Command 4.4.1 

CTD Command 4.3.1 

CTH Command 3.5.5 

CTL Command 4.2.1 

CTP Command 4.4.1 

CTRL3780: 

Command 3.4.13 

TP File Keyword 4.4.5.8 

Data: 

Bases 4.1.1 

Collection 1.3.1 

Distribution 1.3.2 

Structure Validity 3.2.6 

Structu'es 1.6 

Throughput 5.1.5 

Transfer: 

Blocked 3.4.8 

Continuous 3.4.9 

Validate Activity Template 4.5.2, 4.5.4 

Data Set Identifier 3.5.3, 3.5.4, 3.5.5 

Data Base Example, Poller 4.6.3 

DDS Command 4.7 

Deactivate Line 3,3.2, 3.3.3 

Delete Line 4.6.2 

Delete Polier Data Structure (DDS) 

Command 4.7 

Device Definition: 

TPD 5.2.1 

3780 5.2.2 

Device: 

Log 3.2.1,4.1.2,4.6.1 

TPD 5.2 

3780 5.2 

Dial, Manual 3.4.3 

DISC: 

Activity Template Keyword 4.5.5.3 

TP File Keyword 4.4.5.3 

Disk File Usage 1.1 

Disk Storage: 

Calculation Example 5.6.2 

Planning .5.1.3 

Worksheet 5.1.3 

Distribution, Data 1 .3.2 

DO Activity Template Keyword 4.5.5.2 

DS990 1.5.5 

Chassis Space 5.1 .2 

Memory Planning 5.1.6 

DX10: 

Software, Required 1.9 

SVC Error Code Appendix B 

Usage 5.1.5 

3780Emulator(DX3780) 1.5.6 



DX3780 1.5.6 

Build Communications DSR (BCD) 

Parameters 5.2.2 

Build Emulator Task (BET) 

Parameters 5.2.2 

Compression/Expansion 3.4.11 

IDLE Error Patch 5.2.2 

Program File.S$COMMPF 2.2 

Terminal File Name 3.4.11,3.4.12 

Transparency 3.4.1 1 

Vertical Forms Control 3.4.11 

EBCDIC Format 3.5.1,3.5.2 

Edit: 

Commands, Poller Data Base 4.6 

Utilities: 

Activity Template 4.5 

Terminal Data Base 4.3 

Terminal Procedure 4.4 

Emulator, Cabling for Synchronous 

Half-Duplex 3780 FF-2, FF-3 

ENDTP File Keyword 4.4,4.4.5.2 

ERRLOG Task 1.5.4, 4.1.2 

Error: 

Code, DX10SVC Appendix B 

Codes, Log File Appendix B 

Logging 4.1.2 

Task (ERRLOG) 1.5.4 

Messages Appendix B 

Recovery Appendix B 

ERRORS, Event Type 4.1.2 

Event, Log 4.1.2,4.6.1 

Event Type: 

ABORTS 4.1.2 

ALL 4.1.2 

ERRORS 4.1.2 

NORMALS 4.1.2 

STATISTICS 4.1.2 

UNINITIABLES 4.1.2 

Example: 

Activity Template 4.5.6 

Disk Storage Calculation 5.6.2 

Network 5.6 

Poller Data Base 4.6.3 

Polling Line Calculation 5.6.1 

Terminal Data Base 4.3.4 

Terminal List 4.2.3 

Terminal Procedure Data Base 

763/765 4.4.6 

TIBOL Program Download to 767 .. . 4.4.5.8 

EXITTP File Keyword, IFERR 4.4.5.3 

External Modem and ACU Interface . . . .1.8.1 

TTY, Cabling FF-1 

3780, Cabling . FF-2 

File: 

Access Name, 990 3.4.7, 3.4.8, 

3.4.9, 3.4.11, 3.4.12 

Error Codes, Log Appendix B 

Format, Log 3.6.6 

Log 3.2.1,4.1.2,4.6.1 
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File Name: 

BMT 3.4.7,3.4.8,3.4.9 

DX3780 Terminal 3.4.11,3.4.12 

Format: 

Log File 3.6.6 

RECEIVE Keyword: 

TTY 4.4.5.5 

3780 4.4.5.5 

SEND Keyword: 

TTY 4.4.5.4 

3780 4.4.5.4 

Terminal Procedure 4.4 

Full-Duplex TTY, Cabling for 

Asynchronous FF-1 

Functions 1.3 

763/765 BMT 3.4.6 

Generate LRC/SEQ 3.4.7 

Global LUNO: 

(>81) 2.2 

(>82) 2.2 

Guidelines, Network 5.1 

Half-Duplex 3780 Emulator, Cabling 
for Synchronous FF-2, FF-3 

Halt Poller Operation (HPO) 
Command 3.2.2 

Hardware 5.1.2 

Components 1.7 

Options 1.8 

Header Label File Pathname 3.5.5 

HPO Command 3.2.2 

Identifier, Data Set 3.5.3, 3.5.4, 3.5.5 

IDLE Error Patch, DX3780 5.2.2 

IFERR: 

ABORT TP File Keyword 4.4.5.3 

CONTTP File Keyword 4.4.5.3 

DISC TP File Keyword 4.4.5.3 

EXITTP File Keyword 4.4.5.3 

RETRY TP File Keyword 4.4.5.3 

TP File Keyword 4.4.5.3 

Implementation, Network 5.3 

Interface, External Auto Call Unit 1.8.1 

Internal: 

Auto Call Unit 1.8.2 

Modem and ACU, Cabling for FF-3 

Synchronous Modem 1.8.2 

Internal/External Modems 5.2 

Intertask Message Area 5.2.3 

INVOKE: 

Languages 4.4.5.6 

Poller Parameters. 4.4.5.6 

TP File Keyword 4.4.5.6 

User Parameters 4.4.5.6 

Keywords: 

Activity Template 4.5.5 

DISC 4.5.5.3 

DO 4.5.5.2 

USE 4.5.5.1 



Terminal Data Base 4.3.3 

ACTIVITY TEMPLATE 

PATHNAME 4.3.3 

ANSWERBACK 4.3.3 

BAUD RATE 4.3.3 

MODEM TYPE 4.3.3 

PHONE NUMBERS 4.3.3 

PROTOCOL 4.3.3 

RETRY COUNT 4.3.3 

TERMINAL CONNECTION 4.3.3 

TERMINAL TYPE 4.3.3 

WAIT TIME 4.3.3 

WATS BAND 4.3.3 

Terminal Procedure File 4.4.5 

BEGIN 4.4,4.4.5.1 

CTRL3780 4.4.5.8 

END 4.4,4.4.5.2 

IFERR 4.4.5.3 

INVOKE 4.4.5.6 

RECEIVE 4.4.5.5 

SEND 4.4.5.4 

WAIT 4.4.5.7 

TTY Format: 

RECEIVE 4.4.5.5 

SEND 4.4.5.4 

3780 Format: 

RECEIVE 4.4.5.5 

SEND 4.4.5.4 

Kill Task (KT) SCI Command 5.2.3 

Languages, INVOKE 4.4.5.6 

Length, Line 3.4.7 

Limited Processing 1.3.3 

Line: 

Add 4.6.2 

Calculation Example, Polling 5.6.1 

Change 4.6.2 

Connection 3.6.2 

Deactivate 3.3.2, 3.3.3 

Delete 4.6.2 

Lenath 3.4.7 

MACS Chassis 4.6.1 

Mode 3.3.1,4.1.1,4.6.1 

Auto Answer 1.2.2 

Autocall 1.2.1 

Manual 3.4 

Manual Call/Answer 1 .2.3 

Modem Type 4.6.1 

Operation Commands 3.3 

Operations 1.2 

Protocol 3.6.2,4.1.1,4.6.1 

Requirements Worksheet 5.1.2 

Status 3.6.2,3.6.4 

User 3.6.2 

WATS 3.3.1 

WATS Band 4.6.1 

Lines, Number of 5.1.2 

List Log File (LLF) Command 3.6.6 

LLF Command 3.6.6 

Log: 

Device 3.2.1, 4.1.2, 4.6.1 
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Event 4.1.2,4.6.1 

File 3.2.1,4.1.2,4.6.1 

Error Codes Appendix B 

Format 3.6.6 

Logical Record Length 3.5.1, 3.5.2, 3.5.5 

LRC/SEQ: 

Check 3.4.8,3.4.9 

Generate 3.4.7 

MACS Chassis, Line 4.6.1 

Magnetic Tape Planning 5.1.4 

MANSR Command 3.4.1 

Manual: 

Call/Answer Line Mode 1.3.3, 3.4 

Commands 3.4 

Dial 3.4.3 

Manual Answer (MANSR) Command . . . 3.4.1 

Manual Ca!l (MCALL) Command 3.4.3 

Manual Change 3780 Emulator Dynamic 

Parameter (CTRL3780) Command . . .3.4.13 
Manual Disconnect (MDISC) 

Command 3.4.4 

Manual Modify Baud Rate (MBAUD) 

Command 3.4.2 

Manual Receive File Blocked TTY 

(RBLKTTY) Command 3.4.8 

Manual Receive File Continuous 

TTY (RCONTTY) Command 3.4.9 

Manual Receive File 3780 (RFIL3780) 

Command 3.4.12 

Manual Send BMT Command 

TTY (SCMDTTY) Command 3.4.5 

Manual Send BMT Command 

3780 (SCMD3780) Command 3.4.10 

Manual Send BMT Function TTY 

(SFNCTTY) Command 3.4.6 

Manual Send File TTY (SFILTTY) 

Command 3.4.7 

Manual Send File 3780 (SFIL3780) 

Command 3.4.1 1 

MAP, 767/769 3780 Parameter 3.4.12 

Mapping, 767/769 3780 3.4.12 

MAT Command 4.5.3 

Maximum Number of Lines 5.5 

MBAUD Command 3.4.2 

MCALL Command 3.4.3 

MDISC Command 3.4.4 

Medium Commands 3.5 

Memory Planning, DS990 5.1.6 

Memory Requirements 5.1.6 

Worksheet 5.1.6 

Memory-Resident Requirements 5.1.6 

Menu: 

/AT 4.5 

/MTTY 3.4 

/M3780 3.4 

/PCONFG 4.1,4.1.3 

/PCTRL 3.2 

/PD 4.6 

/PLINE 3.3 



/PMANL 3.4 

/PMEDM 3.5 

/POPER 3.1 

/PSTAT 3.6 

/TD 4.3 

111 4.2 

/TP 4.4 

Menus, SCI 2.1,3.1 

Message Format Appendix B 

Messages: 

Error Appendix B 

Status Appendix B 

Mode, Line 3.3.1, 4.6.1 

Auto Answer 1.2.2 

Autocall 1.2.1 

Manual Call/Answer 1.2.3, 3.4 

Model 979A Tape Drive 1 .8.3 

Modem: 

Cabling for Internal FF-3 

Internal/External 5.2 

Internal Synchronous 1.8.2 

Type: 

Line 4.6.1 

Terminal 4.3.1, 4.3.3 

Modify Activity Template (MAT) 

Command 4.5.3 

Modify Poller Data Base (MPD) 

Command 4.6.2 

Modify Terminal Data Base (MTD) 

Command 4.3.2 

Modify Terminal List (MTL) Command . .4.2.2 
Modify Terminal Procedure File (MTP) 

Command 4.4.3 

MPD Command 4.6.2 

MTD Command 4.3.2 

MTL Command 4.2.2 

MTP Command 4.4.3 

Network: 

Example 5.6 

Guidelines 5.1 

Implementation 5.3 

Planning 5.1.1 

NORMALS, Event Type 4.1.2 

Number of: 

Lines 5.1.2 

Tasks for Poller 5.2.3 

Terminals 5.1.2 

Number, Terminal 3.4.1 , 3.4.3, 3.6.3, 4.2.1 

Occurrence Number 3.1, 3.2.1, 

3.2.6,3.6.1,3.6.4 
Operation: 

Attended 4.6.1 

Commands, Line 3.3 

Utilities 1.5.2,3.1 

Operations, Line 1.2 

Operator's Console 3.1 

Option, Restart 5.5 

Options, Hardware 1.8 



lndex-6 



2302679-9701 



Index 



Order, Terminal List 4.2.3 

Other Tasks 5.1 .5 

Overview 1.1 

Parameters, DX3780: 
Build Communications DSR(BCD) . . .5.2.2 

Build Emulator Task (BET) 5.2.2 

Pathname:: 
Activity Template . . . 4.3.1 , 4.3.3, 4.5.2, 4.5.4 

Terminal Data Base 4.3.1, 4.3.2 

Terminal List 4.2.2 

Terminal Procedure File . .4.4.2, 4.4.3, 4.4.4 

PDB 1.6.5, 3.2.1, 3.2.6, 3.6.4, 4.1.1 

PDS Command 4.8 

Phone Numbers, Terminal 4.3.3 

Physical Resource 4.6.1 

PIN Command 5.5 

Planning: 

Disk Storage 5.1 .3 

Magnetic Tape 5.1 .4 

Network 5.1.1 

Sysgen 5.2 

PLAYBACK File, 763/765 3.4.8, 3.4.9 

PMT 1.5.3 

POLL Command 2.2 

Poll Master Task (PMT) 1.5.3 

Rebuilding 5.5 

Poller Data Base 1 .6.5, 3.2.1 , 3.2.6, 

3.6.1,3.6.4,4.1.1 

Edit Commands 4.6 

Example 4.6.3 

Poller Initialization (PIN) Command 5.5 

Poller Parameters, INVOKE 4.4.5.6 

Poller Program File V.P$PROGA 2.2 

Polling: 

Line Calculation Example 5.6.1 

Sequence 4.1.1 

Session, Terminal 1.4 

Time, Allowable 5.1.2 

Power Failure Restart 3.2.3 

PQ Command 2.3 

Presentation Service Task (PS) 1.5.5 

Print Poller Data Structure (PDS) 

Command 4.8 

Processing, Limited 1.3.3 

Program File: 

Poller, V.P$PROGA 2.2 

DX3780, .S$COMMPF 2.2 

Protocol: 

Line 3.6.2,4.1.1,4.6.1 

Terminal 3.6.3,4.3.1,4.3.3 

PS Task 1.5.5 

PSTTY765 1.5.5 

PS3780 1.5.5 

QCAT Command 4.5.2 

QCTP Command 4.4.2 

QM AT Command 4.5.4 

QMTP Command 4.4.4 

Quit Create Activity Template (QCAT) 
Command 4.5.2 



Quit Create Terminal Procedure 

File (QCTP) Command 4.4.2 

Quit Modify Activity Template (QMAT) 

Command 4.5.4 

Quit Modify Terminal Procedure 

File (QMTP) Command 4.4.4 

Rate, Terminal Baud 4.3.1 

RBLKTTY Command 3.4.8 

RCONTTY Command 3.4.9 

Read from IBM-Standard Labeled 

Magnetic Tape (RFLT) Command . . . .3.5.4 
Read from Magnetic Tape to Disk 

(RMTD) Command 3.5.2 

Read IBM-Standard Labeled Tape 

Utility 3.5.4 

Read Unlabeled Tape Utility 3.5.2 

Rebuilding Poll Master Task (PMT) 5.5 

RECEIVE: 

File name: 

??Suffixto 4.4.5.5 

??? Suffix to 4.4.5.5 

Keyword, TP File 4.4.5.5 

TTY Format 4.4.5.5 

3780 Format 4.4.5.5 

RECORD File, 763/765 3.4.7 

Recovery, Error Appendix B 

Remote 990 Terminal Characteristics . . . .C.3 
Request Line Status (RLS) Command . . . 3.6.2 
Request Poller Status (RPS) 

Command 3.6.1 

Request Terminal Status (RTS) 

Command 3.6.3 

Required DX10 Software 1.9 

Requirements: 

Memory-Resident 5.1.6 

Worksheet, Line 5.1.2 

Restart: 

Option 5.5 

Power Failure 3.2.3 

Terminal Session 3.2.3 

Restart Poller Operation (RPO) 

Command 3.2.3 

Retry Count, Terminal 4.3.3 

RETRY TP File Keyword, IFERR 4.4.5.3 

RFIL3780 Command 3.4.12 

RFLT Command 3.5.4 

RLS Command 3.6.2 

RMTD Command 3.5.2 

RPO Command 3.2.3 

RPRRL 3.4.13, 4.4.5.8 

RPS Command 3.6.1 

RTS Command 3.6.3 

SCI 2.1 

Command, Kill Task (KT) 5.2.3 

Commands 2.1 

Menus 2.1,3.1 

SCMDTTY Command 3.4.5 

SCMD3780 Command 3.4.10 

SDS Command 4.9 
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SEND Fi!e name: 

?? Suffix to 4.4.5.4 

??? Suffix to 4.4.5.4 

SEND Keyword 4.4.5.4 

TTY Format 4.4.5.4 

3780 Format 4.4.5.4 

Sequence: 

Polling 4.1.1 

Terminal 3.2.1 

Session, Terminal: 

Abort 3.3.3 

Restart 3.2.3 

Polling 1.4 

Terminate 3.2.4, 3.3.2 

SFILTTY Command 3.4.7 

SFIL3780 Command 3.4.11 

SFNCTTY Command 3.4.6 

Show Log File (SLF) Command 3.6.5 

Show Poller Activity (SPA) Command . . . 3.6.4 
Show Poller Data Structure (SDS) 

Command 4.9 

SLF Command 3.6.5 

SLO Command 3.3.1 

Software 

Installation 5.4 

Required DX10 1.9 

Structure 1.5,1.5.7 

SPA Command 3.6.4 

SPO Command 3.2.1 

SRL 3.4.13,4.4.5.8 

Start Line Operation (SLO) Command . . . 3.3.1 
Start Poller Operation (SPO) 

Command 3.2.1 

Start Time 3.2.1 

State 3.6.1,3.6.4 

STATISTICS, Event Type 4.1.2 

Status 3.6.1 

Commands 3.6 

Line 3.6.2,3.6.4 

Messages Appendix B 

Terminal 3.6.3 

Structure Validity, Data 3.2.6 

Structures, Data 1.6 

Subsystems, Communications 1.5.6 

SVC Error Code, DX10 Appendix B 

Synchronous: 

Half-Duplex 3780 Emulator, 

Cabling for FF-2, FF-3 

Modem, Internal 1.8.2 

Synonym: 

V 2.2,2.3 

$OCC$ 2.3,3.2.1,3.6.1 

Sysgen Planning 5.2 

System Command Interpreter 2.1 

System Control Commands 3.2 

System Table Area 5.2.3 

Tape Drive, Model 979A 1.8.3 

Task* 

ERRLOG 1.5.4,4.1.2 

PS 1.5.5 



Tasks: 

for Poller, Number of 5.2.3 

Other 5.1.5 

TDB 1.6.2, 3.2.1, 3.2.6, 3.6.4, 4.1.1 

Telephone Number 3.4.3 

Terminal: 

Baud Rate 4.3.1, 4.3.3 

Cabling for: 

763/765 FF-1 

767/769 FF-2, FF-3 

Characteristics: 

Remote 990 C.3 

763/765 C.1 

767/769 C.2 

Connection 3.6.3, 4.3.1 , 4.3.3 

Connection Type 4.1.1 

File Name, DX3780 3.4.11, 3.4.12 

Modem Type 4.3.1, 4.3.3 

Number 3.4.1, 3.4.3, 3.6.3, 4.2.1 

Phone Numbers 4.3.3 

Polling Session 1.4 

Protocol 3.6.3, 4.3.1, 4.3.3 

Retry Count 4.3.3 

Sequence 3.2.1 

Session: 

Abort 3.3.3 

Restart 3.2.3 

Terminate 3.2.4, 3.3.2 

Status 3.6.3 

Type 4.3.1,4.3.3,5.1.2 

Wait Time 4.3.3 

WATS Band 4.3.1,4.3.3 

Terminal Data Base 1.6.2, 3.2.1, 3.2.6, 

3.6.1, 3.6.4, 4.1.1 

Edit Utilities 4.3 

Example 4.3.4 

Keywords 4.3.3 

Pathname 4.3.1 , 4.3.2 

Terminal List 1.6.1, 3.2.1, 3.2.6, 

3.6.1, 3.6.4, 4.1.1 

Edit Utilities 4.2 

Example 4.2.3 

Order 4.2.3 

Pathname 4.2.2 

Terminal Procedure: 

Blank Lines 4.4 

Comment Lines 4.4 

Data Base: 

Data, Validate 4.4.2, 4.4.4 

Keywords 4.4.5 

Pathname 4.4.2, 4.4.3, 4.4.4 

Edit Utilities 4.4 

Format 4.4 

Terminal Procedure Data Base . . .1.6.4, 4.1.1 

763/765 Example 4.4.6 

Terminals, Numberof 5.1.2 

Terminate Line Operation (TLO) 

Command 3.3.2 

Terminate Poller Operation (TPO) 

Command 3.2.4 

Terminate Terminal Session 3.2.4, 3.3.2 
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TEST Command 3.2.6 

Test Poller Operation (TEST) 
Command 3.2.6 

Throughput, Data 5.1.5 

Tl: 

763/765 1.5.5 

767/769 1.5.5 

TIBOL Program Download to 767 

Example 4.4.5.8 

Time: 

Allowable Polling 5.1.2 

Wait: 

Between Tries 5.5 

Terminal 4.3.3 

TL 1.6.1, 3.2.1, 3.2.6, 3.6.4, 4.1.1 

TLO Command 3.3.2 

TP File Keyword: 

BEGIN 4.4,4.4.5.1 

CTRL3780 4.4.5.8 

END 4.4,4.4.5.2 

IFERR 4.4.5.3 

ABORT 4.4.5.3 

CONT 4.4.5.3 

DISC 4.4.5.3 

EXIT 4.4.5.3 

RETRY 4.4.5.3 

INVOKE 4.4.5.6 

RECEIVE 4.4.5.5 

SEND 4.4.5.4 

WAIT 4.4.5.7 

TPD 1.6.4,4.1.1 

Device 5.2 

Device Definition 5.2.1 

TPO Command 3.2.4 

TRA, 767/769 3780 Parameter 3.4.12 

TRAILB 3.4.13,4.4.5.8 

Transfer, Data: 

Blocked 3.4.8 

Continuous 3.4.9 

Transparency: 

CTRL3780 4.4.5.8 

DX3780 3.4.11 

767/7693780 3.4.12 

Tries of Polling List 5.5 

TTY: 
Cabling for Asynchronous 

Full-Duplex FF-1 

Format: 

RECEIVE Keyword 4.4.5.5 

SEND Keyword 4.4.5.4 

TY 3.4.11, 3.4.13,4.4.5.8 

Type, Terminal 4.3.1 , 4.3.3, 5.1 .2 

Unattended Operation 4.6.1 

UNINITIABLES, Event Type 4.1.2 

Usage: 

Disk File 1.1 

DX10 5.1.5 

911 VDT 1.1,3.1 

USE Activity Template Keyword 4.5.5.1 

User, Line 3.6.2 



User Parameters, INVOKE 4.4.5.6 

Utilities: 

Activity Template Edit 4.5 

Configuration Management 1.5.1,4.1 

Operation 1.5.2 

Terminal Data Base Edit 4.3 

Terminal List Edit 4.2 

Terminal Procedure Edit 4.4 

Utility: 

Read IBM-Standard Labeled Tape 3.5.4 

Read Unlabeled Tape 3.5.2 

Write IBM-Standard Labeled Tape 3.5.3 

Write Unlabeled Tape 3.5.1 

V, Synonym 2.2, 2.3 

Validate: 

Activity Template Data 4.5.2, 4.5.4 

Terminal Procedure File Data . .4.4.2, 4.4.4 

Validity, Data Structure 3.2.6 

Vertical Forms Control: 

CTRL3780 4.4.5.8 

DX3780 3.4.11 

767/7693780 3.4.12 

VFC 3.4.11, 3.4.13, 4.4.5.8 

Volume Serial Number 3.5.3, 3.5.4, 3.5.5 

V.P$PROGA, Poller Program File 2.2 

Wait Time: 

Between Tries 5.5 

Terminal 4.3.3 

WAITTP File Keyword 4.4.5.7 

Testing DX10$$CC Value 4.4.5.7 

WATS Band 4.1.1 

Line 3.3.1,4.6.1 

Matching 5.5 

Terminal 4.3.1, 4.3.3 

WDTM Command 3.5.1 

Worksheet: 

Disk Storage 5.1 .3 

Line Requirements 5.1.2 

Memory Requirements 5.1.6 

Write from Disk to Magnetic Tape 

(WDTM) Command 3.5.1 

Write IBM-Standard Labeled Tape 

Utility 3.5.3 

Write to IBM-Standard Labeled 

Magnetic Tape (WTLT) Command . . . .3.5.3 

Write Unlabeled Tape Utility 3.5.1 

WTLT Command 3.5.3 

$OCC$, Synonym 2.3, 3.2.1, 3.6.1 

.S$COMMPF, DX3780 Program File 2.2 

/AT Menu 4.5 

/MTTYMenu 3.4 

/M3780Menu 3.4 

/PCONFG Menu 4.1, 4.1.3 

/PCTRLMenu 3.2 

/PD Menu 4.6 

/PLINEMenu 3.3 

/PMANLMenu 3.4 
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/PMEDM Menu 3.5 

/POPERMenu 3.1 

/PSTATMenu 3.6 

/TDMenu 4.3 

/TLMenu 4.2 

/TPMenu 4.4 

3780: 
Compression/Expansion, 767/769 . . .3.4.12 

Device 5.2 

Device Definition 5.2.2 

Emulator, Cabling for Synchronous 

Half-Duplex FF-2, FF-3 

Format: 

RECEIVE Keyword 4.4.5.5 

SEND Keyword 4.4.5.4 

Mapping, 767/769 3.4.12 

Parameter: 

COM, 767/769 3.4.12 

MAP, 767/769 3.4.12 

TRA, 767/769 3.4.12 

Transparency, 767/769 3.4.12 

763/765 BMT, Tl 1.5.5 

Commands 3.4.5 

Functions 3.4.6 

PLAYBACK File 3.4.8, 3.4.9 



RECORD File 3.4.7 

Terminal: 

Cabling for FF-1 

Characteristics C.1 

767/769 BMT, Tl 1.5.5 

BMT Command 3.4.10 

Terminal: 

Cabling for FF-2, FF-3 

Characteristics C.2 

3780 Parameter: 

COM 3.4.12 

Compression/Expansion 3.4.12 

MAP 3.4.12 

Mapping 3.4.12 

TRA 3.4.12 

Transparency 3.4.12 

91 1 VDT Usage 1.1 , 3.1 

990 File Access Name 3.4.7, 3.4.8, 

3.4.9, 3.4.11, 3.4.12 

?? Suffix to: 

RECEIVE Filename 4.4.5.5 

SEND Filename 4.4.5.4 

??? Suffix to: 

RECEIVE Filename 4.4.5.5 

SEND Filename 4.4.5.4 
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(A complete listing of U.S. offices is available from the 
district office nearest your location) 



California 

831 S. Douglas Street 

El Segundo, California 90245 

(213) 973-2571 

100 California Street 

Suite 480 

San Francisco, California 94111 

(415) 781-9470 

776 Palomar Avenue 
P.O. Box 9064 
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(408) 732-1840* 
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(714) 540-7311 
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Suite 301 
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(303) 751-1780 
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1850 Lee Road 

Suite 115 

Winter Park, Florida 32789 

(305) 644-3535 
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3300 Northeast Expressway 
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(404) 458-7791 
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Illinois 

515 West Algonquin Road 
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(312) 640-2900 
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1245 Westfield Avenue 
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Pennsylvania 

420 Rouser Road 
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(412) 771-8550 
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8001 Stemmons Expressway 

P.O. Box 226080 

M/S3108 
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(214) 689-4460 

13510 North Central Expressway 

P.O. Box 225214 

M/S393 
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(214) 238-3881 

9000 Southwest Freeway, Suite 400 
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(713) 776-6577 

8585 Commerce Drive, Suite 518 
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(713) 776-6531 
(713) 776-6553* 
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